MSIX Paketleme Aracı için bilinen sorunlar ve sorun giderme ipuçları

Bu makalede, bilinen sorunlar açıklanır ve MSIX Paketleme Aracı'nı kullanarak uygulamalarınızı MSIX'e dönüştürürken göz önünde bulundurmanız gereken sorun giderme ipuçları sağlanır. Bağlantısız ortamlarda MSIX Paketleme Aracı'nı veya sürücüsünü edinmeniz gerekiyorsa diğer belgelerimize göz atın.

Bilinen sorunlar

MSIX Paketleme Aracı'nın en son Insider Preview derlemesini alma

Insider Programımızı kabul ettiyseniz MSIX Paketleme Aracı'nın doğru sürümüne sahip olduğunuzdan emin olun:

• Hangi sürümde olduğunuzu görmek için MSIX Paketleme Aracı'ndaki Hakkında bölümüne gidin.
• En son Insider Preview sürümünü belirlemek için buraya gidin ve MSIX Paketleme Aracı'nın bu sürümünün yüklü olduğunu onaylayın.
• Microsoft Store'da oturum açmış olan hesabın, uçuş denemeleri için kaydolunan MSA ile aynı hesap olduğundan emin olun.
• MSIX Paketleme Aracı'nı bilgisayarınızdaki Microsoft Store üzerinden manuel olarak güncelleyin. Bu seçenek kullanılabiliyorsa Mağaza'yı açın, İndirmeler ve güncelleştirmeler'e gidin ve Güncelleştirmeleri al'a tıklayın. Alternatif olarak, MSIX Paketleme Aracı'nı arayın ve ürün sayfasında bir güncelleştirme isteyebilirsiniz.
• ÇEVRIMDıŞı kullanım için MSIX Paketleme Aracı'nı yüklemek için, çevrimdışı işlemimiz aracılığıyla en son uygulamayı aldığınızdan emin olmak için bu yönergeleri izleyin.

Insider Programımıza katılmak istiyorsanız , MSIX Paketleme Aracı Insider'lara Katılın! bölümüne gidin.

MSIX Paketleme Aracı sürücüsü

MSIX Paketleme Aracı sürücüsü, Windows Update Feature on Demand (FOD) paketi olarak teslim edilir. Bilgisayarda Windows Update hizmeti devre dışı bırakıldıysa veya Windows Insider uçuş halkası ayarları bilgisayarın işletim sistemi derlemesiyle eşleşmiyorsa yüklenemiyor.

Sürücüyü edinmeyle ilgili sorunlarla karşılaşıyorsanız veya çevrimdışı bir ortamda çalışıyorsanız, sürücüyü indirme bağlantılarını burada bulabilirsiniz.

Sürücüyü indirdiyseniz ve paket dönüştürme işlemi sırasında sorunlarla karşılanıyorsanız, bu aşağıdaki sorunlardan biri olabilir.

Ağ bağlantısı sorunları

Aşağıdaki hata kodları bağlantı sorunlarıyla karşılaştığınızı gösterebilir:

• -2145107924 (0x8024402c)
• -2145107945 (0x80244017)
• -2145123272 (0x80240438)

Windows Update bağlantısını etkileyen Windows Server Güncelleştirme Hizmeti (WSUS), Yapılandırma Yöneticisi veya grup ilkeleri

Aşağıdaki hata kodu, bilgisayarınızdaki ilkelerin Windows Update bağlantıyı etkilediğini gösterebilir: -2145124306 (0x8024002e).

Bu hata kodunu alırsanız , ortam ayarlarınızı ve ilkelerinizi denetlemeniz gerekebilir.

Sürücü yeniden yükleme gerektiriyor

Bu senaryoda, MSIX Paketleme Aracı hata mesajında ve günlüklerde sizi sürücünüzün yeniden başlatılması gerektiği konusunda bilgilendirir. Bu sorunu çözmek için bilgisayarınızı yeniden başlatın ve dönüştürme işleminizi yeniden başlatın.

MSIX paketleme aracı sürücüsü 0x80131500 başlatılırken hata oluştu

Dönüştürme sırasında bu hatayı alırsanız, günlük dosyasını denetlediğinizde aşağıdakine benzer bir giriş bulmanız gerekir:

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

Bu hata, araç yeni bir sistem olayı izleme oturumu başlattığında, ancak Windows sistem genelinde oluşturabilecek en fazla oturum sayısını aştığınızda oluşur. Varsayılan sınırı (64) aşarsanız, sürücünün başarısız olmasına neden olan bir ERROR_NO_SYSTEM_RESOURCES hatasıyla karşılaşırsınız.

Çözüm, aşağıdaki adımları izleyerek mevcut Olay İzleme oturumlarından bazılarını durdurmaktır:

1. Başlat menüsünü açın ve Performans İzleyicisi arayın.
2. Buna sağ tıklayın ve Diğer -> Yönetici Olarak Çalıştır'ı seçin.
3. Ağaç menüsünde Veri Toplayıcı Kümeleri -> Olay İzleme Oturumları'nı seçin.
4. Listede var olan oturumlardan bazılarına sağ tıklayın ve Durdur'u seçin.

Artık DÖNÜŞTÜRME işlemini MSIX Paketleme Aracı ile yeniden gerçekleştirmeyi deneyebilirsiniz.

En düşük sürüm

MSIX Paketinizde minimum sürüm desteğini otomatik olarak değiştiren birkaç özellik bulunmaktadır.

Microsoft Store sürüm numaralandırma gereksinimlerini zorunlu kılmak

Mevcut yükleyicinizi MSIX Paketleme Aracı'nın 1.2019.701.0 sürümünden önceki bir sürümüyle dönüştürürseniz, araç varsayılan olarak Microsoft Store sürüm oluşturma gereksinimlerini uyguluyordu veya başka bir araç kullandıysanız, paketin minimum sürümünü 10.0.16299.0 (Windows 10, sürüm 1709) olarak ayarlamıyordu. Bu, uygulamanızı Windows 10, sürüm 1709 veya sonraki bir sürüme dağıtırken hata iletisine neden olur.

Bu sorunu çözmek için MSIX Paketleme Aracı'nı açın ve Uygulamanızı Paket Düzenleyicisi aracılığıyla düzenleyin. Bildiriminizi açın ve öğesinin MinVersionTargetDeviceFamily özniteliğini "10.0.16299.0" olarak ayarlayın.

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

Hizmetlerle MSIX

MSIX Paketleme Aracı'nın 1.2019.1220.0 sürümünde Hizmetler ile MSIX paketi oluşturma desteği ekledik. Hizmet desteğine sahip işletim sistemi kısıtlamaları nedeniyle MSIX Paketleme Aracı, hizmetler içeren bir MSIX paketinde desteklenen en düşük sürümü otomatik olarak 10.0.19025.0 olarak değiştirir. Bu, Windows 10 sürüm 2004'ten daha düşük bir işletim sistemine hizmetler içeren bir MSIX yükleyemeyeceğiniz anlamına gelir, ancak MSIX Paketleme Aracı'nı kullanarak bu MSIX'i Windows 10 1809'a kadar oluşturabilirsiniz. Bu uygulamayı daha düşük bir işletim sistemine yüklemeniz gerekiyorsa en düşük sürümü uygun şekilde güncelleştirin, ancak hizmetlere yönelik desteğin çalışmayacağını unutmayın.

Çerçeveler ve sürücüler

Uygulama bir çerçeve gerektiriyorsa, dönüştürmenin izleme aşamasında çerçevenin yüklendiğinden emin olun. Bunun gerçekleştiğinden emin olmak için günlükleri inceleyin. Uygulamanızın yüklenmesi için bir sürücü gerekiyorsa, uygulamanızın düzgün çalışması için bunun gerekli olup olmadığını değerlendirmeniz gerekir. MSIX şu anda sürücü yüklemesini desteklemiyor.

Uzak Makine

Dönüştürmeleriniz için uzak vm kullanmayla ilgili sorunlarla karşı karşınıza çıkarsa bkz. Uzak makine dönüştürmeleri için kurulum yönergeleri.

Dönüştürme sırasında karşılaşılan sorunlar

• Bazı yükleyiciler çıkış kodu 259 ile dönüştürülemeyebilir. Bu, yükleyicinin bir iş parçacığı başlattığını ve tamamlanmasını beklemediğini gösterir. Başka bir deyişle, ana iş parçacığı kurulumu tamamladı, ancak hâlâ çalışan bir iş parçacığı başlattığından dolayı 259 hatasıyla çıkış yaptı. setup.exeiçin uygun yükleme seçeneğini kullanmanızı öneririz.

İmzalama sırasında karşılaşılan sorunlar

Hatalı PE sertifikası (0x800700C1)

Paket bozuk sertifikaya sahip bir ikili dosya içerdiğinde bu sorun oluşur. Bu sorunu çözmek için dumpbin.exe /headers komutunu kullanın, dosya üst bilgilerini dökün ve hatalı öğeleri inceleyin. Sorunu çözmek için üst bilgileri el ile yeniden yazabilirsiniz. Genel olarak, MSIX Paketleme aracı hatalı üst bilgileri otomatik olarak algılar. Bu sorun devam ederse geri bildirim gönderin. Burada daha fazla bilgi bulabilirsiniz.

Device Guard imzalama işlemi

Bu adımları izlediğinizden ve Microsoft Store İş için uygun rolleri atadığınızdan emin olun.

Süresi dolmuş sertifika

• Paketinizi imzalarken zaman damgası kullanın.
• Geçerli bir işaret veya zaman damgası sertifikasıyla istifa edebilirsiniz.

MSIX Araç Seti - Betikler'deki toplu dönüştürme betiğini kullanarak uygulamanızdan istifa edebilirsiniz.

Sorun giderme

Kayıt dosyaları

Dönüştürme işleminiz başarılı olsa da olmasa da, her dönüştürme için günlük dosyaları oluşturulur. Bunlar burada bulunabilir:

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

Hata kodları yazılır ve dönüştürme işlemi sırasında herhangi bir hata noktasını gösterir. Hata kodlarının kullanıcı dostu olması amaçlanır.

Uzak cihazlardan veya VM'lerden günlük dosyaları

Dönüştürme uzak bir cihazda veya VM'de gerçekleştiriliyorsa, günlük dosyalarını bu cihazdan kopyalamanızı ve geri bildirim öğesinin bir parçası olarak eklemenizi öneririz. Bu, sorunları daha verimli bir şekilde tanılamamıza ve çözmemize yardımcı olur.

Uzaktan dönüştürmelerden günlükleri burada bulabilirsiniz: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Yerel istemcide ve uzak sunucuda gerçekleşen işlemleri içerecek günlükler klasörünün tamamını paylaşabiliyorsanız daha da yararlı olur.

Sık karşılaşılan sorunlar

MakePri/Manifest çevirisi hataları

Bu hata, paketin bildiriminde bir sorun olduğunda oluşur. Sorunu tanımlamak için Paket Düzenleyicisi'ne gidin ve bildirimi açın. Bildirimi açtığınızda, sorunu tanımlayabilir ve uygun düzeltmeyi sağlayabilirsiniz.

Dosya bulunamadı

Dosya açık veya varolmamış olabilir. Bu sorunu çözmek için uygun dosyayı ekleyin veya şu anda kullanımda olan dosyayı kapatın. Açık olduğunda File not Found hatası almazsınız. Bunun yerine bir Access Denied veya File in Use hatası alırsınız.

Dosya Türü İlişkilendirmeleri

Dosya Türü İlişkilendirmeleri (FTA) ile ilgili sorunlar paketten pakete farklılık gösterir. MSIX Paketleme Aracı, çift tıklama yüklemeleri için dosya ilişkilendirmelerini destekler. Örneğin, uygulamanız bağlam menüsüne sahipse otomatik olarak eklenmez, bu nedenle bildirime el ile eklemeniz gerekir. Bir örnek için desktop4:FileExplorerContextMenus bildirim öğesine bakın.

Bağımsız değişkenler içeren kısayollar

MSIX Paketleme Aracı, kullanıcı düzeyindeki tüm kısayolları ve bu kısayollara ait bağımsız değişkenleri yakalar. Bu kısayolların düzgün algılanmaması durumunda bildirime el ile ekleyebilirsiniz. Daha fazla ayrıntı için masaüstü7:Kısayol bölümüne bakın.

Dizini yükleme

Bu, uygulama dönüştürmeleri gerçekleştirmek için ikincil sürücü kullananlar için daha yaygındır. Yükleme konumunu değiştirmeyi seçerseniz, tüm dosyaların nereye gittiği kökünü değiştirir. Bu, MSIX Paketleme aracının tüm bu dosyaların nereye gittiğini bilmesi gerektiği ve dönüştürme sırasında yakalanacağı anlamına gelir.

Dizin düzeltmesini yüklemek için Paket Destek Çerçevesi yazmasını kullanarak bunu düzeltebilirsiniz. MSIX Aracı'nda varsayılan bir özellik olarak eklediğimiz bu özellik, 1809 sürümünden itibaren kullanılabilir. Uygulamanız 1709'da çalışmıyorsa ve 1809'daysa, sorun büyük olasılıkla budur.

Geri bildirim gönderme

Geri bildirim göndermenin en iyi yolu Geri Bildirim Merkezi'ni kullanmaktır.

1. Feedback Hub açın veya Windows + F yazın.
2. Sorunu yeniden oluşturmak için bir başlık ve gerekli adımları belirtin.
3. Kategori'nin altında Uygulamalar'ı ve ardından MSIX Paketleme Aracı'nı seçin.
4. Dönüştürmeyle ilişkili tüm günlük dosyalarını ekleyin. Günlükleri yukarıda sağlanan klasörde bulabilirsiniz.
5. Dönüştürülen MSIX paketini ekleyin (mümkünse).
6. Gönder'i tıklatın.

Ayrıca, Ayarlar'ın altındaki Geri Bildirim sekmesine giderek doğrudan MSIX Paketleme Aracı'ndan bize geri bildirim gönderebilirsiniz.

Uyarı

Geri bildiriminizin bize ulaşmış olması 24 saat sürebilir. Bu nedenle, paketinizi dönüştürmek için bir VM kullanıyorsanız, dönüştürmeden sonra VM'nizi 24 saat boyunca açık ve geçerli durumunda tutmak isteyebilirsiniz. Ayrıca, geri bildirime dönüştürme günlüklerini el ile ekleyebilirsiniz.