Instal aplikasi sebelumnya menggunakan DISM

Artikel
05/09/2023

Catatan

Tertarik untuk menginstal aplikasi Microsoft Store sebelumnya, tetapi Anda bukan OEM? Untuk informasi tentang memuat samping aplikasi untuk organisasi, lihat Aplikasi Sideload dengan DISM.

Topik ini membahas cara menginstal aplikasi sebelumnya sehingga disertakan sebagai bagian dari gambar Windows.

Tip

Aplikasi Dukungan Perangkat Keras (HSA) adalah Aplikasi Microsoft Store, dan instruksi berikut berlaku.

Bekerja dengan paket aplikasi

Gunakan DISM untuk memprovisikan aplikasi secara offline ke dalam gambar. Anda dapat menggunakan DISM dari Command Prompt, atau cmdlet DISM di Windows PowerShell.

Dalam versi Windows 10 sebelumnya, aplikasi Universal yang telah diinstal sebelumnya dan aplikasi Microsoft Store harus disematkan ke menu Mulai. Windows akan menghapus aplikasi yang telah diinstal sebelumnya tetapi tidak disematkan ke menu Mulai.

Dimulai dengan Windows 10, versi 1803, aplikasi dapat diinstal sebelumnya tanpa disematkan ke Menu Mulai saat Anda menggunakan DISM /add-provisionedappxpackage dengan /region opsi . Saat menginstal aplikasi sebelumnya, Anda dapat memilih untuk meninggalkan aplikasi dari LayoutModification.xml dan aplikasi akan berhasil diinstal tanpa muncul sebagai petak Menu Mulai. Ketika daftar wilayah TIDAK ditentukan, aplikasi akan disediakan hanya jika disematkan untuk memulai tata letak.

Mengekstrak file paket

Telusuri ke folder tempat Anda menyimpan paket aplikasi yang Anda unduh dari Dasbor Mitra.
Klik kanan setiap folder .zip yang berisi file paket aplikasi Anda. Klik Ekstrak Semua dan pilih lokasi untuk menyimpan folder file paket.

Folder berisi semua file yang belum dikemas untuk paket, termasuk paket utama, paket dependensi apa pun, dan file lisensi.

Penting

Jangan ubah folder setelah Anda mengekstrak file paket. Jika Anda mengubah, menambahkan, atau menghapus file apa pun di folder, aplikasi akan gagal baik selama penginstalan atau peluncuran. Bahkan menjelajah folder dapat menyebabkan masalah.

Anda harus menggunakan file lisensi dari file paket untuk menguji gambar yang disediakan. Membuat file data kustom Anda sendiri tidak akan memungkinkan Anda untuk menguji aplikasi yang telah diinstal sebelumnya secara akurat oleh OEM.

Untuk provisi offline aplikasi ke dalam gambar, Anda dapat menggunakan alat Dism.exe atau cmdlet DISM di Windows PowerShell untuk menambahkan aplikasi dari folder file yang belum dikemas.

Menginstal aplikasi yang ditandatangani Microsoft Store dengan DISM

Buka Prompt Perintah sebagai administrator.

Pasang gambar Windows untuk yang ingin Anda layanan:

Dism /Mount-Image /ImageFile:c:\images\myimage.wim /Index:1 /mountdir:c:\test\offline

Tambahkan aplikasi ke gambar yang dipasang. /PackagePath Gunakan opsi dan /DependencyPackagePath .
- Packagepath adalah jalur ke bundel .appx atau file paket
- DependencyPackagePath adalah jalur untuk menentukan setiap paket dependensi. Anda dapat memiliki lebih dari satu dependensi per perintah.
- Baru di Windows 10, versi 1803: Gunakan Region opsi saat menambahkan aplikasi. Region memungkinkan Anda menambahkan aplikasi tanpa harus menyematkan aplikasi ke Menu Mulai.
```
Dism /Image:c:\test\offline /Add-ProvisionedAppxPackage /PackagePath:c:\downloads\package.appxbundle /DependencyPackagePath:c:\downloads\dependency1.appx /DependencyPackagePath:c:\downloads\dependency2.appx /LicensePath=c:\downloads\package_License1.xml /region=all"
```
Lihat opsi baris perintah layanan paket aplikasi DISM untuk informasi tentang bekerja dengan paket aplikasi, termasuk opsi /region baru..
Sematkan aplikasi ke Menu Mulai.
- Jika Anda tidak menentukan /region kapan menginstal aplikasi sebelumnya, sematkan aplikasi ke Menu Mulai dengan LayoutModification.xml.
  
  atau
- Jika Anda menentukan /region saat menginstal aplikasi sebelumnya, dan Anda ingin menyematkan aplikasi ke Menu Mulai untuk wilayah tertentu, gunakan RequiredStartGroups Region="region1|region2" elemen di LayoutModification.xml untuk menentukan wilayah tempat Anda ingin aplikasi muncul.
Simpan perubahan dan lepaskan gambar. Pada prompt perintah, ketik:
```
Dism /Unmount-Image /mountdir:c:\test\offline /commit
```

Catatan

Aplikasi Microsoft Store tidak berjalan dalam mode audit. Untuk menguji penyebaran Anda, jalankan Windows dan buat profil pengguna baru. Untuk informasi selengkapnya tentang mode audit, lihat Gambaran umum mode audit.

Penting Jika Anda telah menginstal aplikasi perangkat broadband seluler, Anda harus memasukkan kartu SIM ke PC sebelum menjalankan fase khusus Sysprep. Untuk informasi selengkapnya tentang menginstal aplikasi perangkat broadband seluler sebelumnya, lihat Menginstal Komponen yang Diperlukan untuk Pengalaman Aplikasi Broadband Seluler.

Memperbarui atau menghapus paket

Anda dapat menghapus aplikasi yang telah diinstal sebelumnya, termasuk lisensi dan file data kustom, dari gambar Windows dengan menggunakan alat DISM.exe atau cmdlet DISM di Windows PowerShell. Anda harus menghapus versi lama aplikasi sebelum menginstal yang baru.

Menghapus aplikasi yang telah diinstal sebelumnya dengan menggunakan DISM

Buka Prompt Perintah Alat Penyebaran, yang diinstal dengan Windows ADK, dengan hak istimewa administrator. Dari layar Mulai, ketik Lingkungan Alat Penyebaran dan Pencitraan, klik kanan ikon, dan pilih Jalankan sebagai Administrator.

Pasang gambar offline untuk layanan. Pada prompt perintah, ketik:

Dism /Mount-Image /ImageFile:c:\images\myimage.wim /Index:1 /mountdir:c:\test\offline

Temukan nama paket lengkap aplikasi yang ingin Anda hapus. Pada prompt perintah, ketik:
```
Dism /Image:C:\test\offline /Get-ProvisionedAppxPackages
```

Hapus aplikasi dari gambar yang dipasang. Misalnya, pada prompt perintah, ketik:

Dism /Image:c:\test\offline /Remove-ProvisionedAppxPackage /PackageName:microsoft.devx.appx.app1_1.0.0.0_neutral_en-us_ac4zc6fex2zjp

Jika ingin memperbarui aplikasi, Anda dapat menginstal aplikasi yang ditandatangani Microsoft Store versi sebelumnya. Pada prompt perintah, ketik:
```
Dism /Image:c:\test\offline /Add-ProvisionedAppxPackage/FolderPath:c:\downloads\appxpackage
```
Simpan perubahan dan lepaskan gambar. Pada prompt perintah, ketik:
```
Dism /Unmount-Image /mountdir:c:\test\offline /commit
```

Menggunakan file data kustom

Aplikasi yang telah diinstal sebelumnya pada PC dapat mengakses data kustom khusus untuk penginstalan. Data kustom ini ditambahkan ke aplikasi selama pra-instalan dan tersedia saat runtime. Data kustom memungkinkan pengembang untuk menyesuaikan fitur dan fungsionalitas aplikasi, termasuk menyediakan kemampuan pelaporan.

Menambahkan file data kustom ke gambar Windows

Anda harus menentukan file data kustom saat menginstal aplikasi sebelumnya dengan menggunakan alat DISM dan melalui Windows PowerShell menggunakan cmdlet Add-AppxProvisionedPackage. Perintah berikut menunjukkan cara melakukan ini menggunakan alat DISM:

Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage / FolderPath:f:\Apps\Fabrikam_KnowMyPC /CustomDataPath:f:\Contoso_Promotion.xml

Jika file data kustom sudah ada di penyimpanan data untuk aplikasi—misalnya, jika paket telah ditambahkan ke gambar—file yang ada ditimpa. Jika penginstalan gagal, file tidak dipulihkan.

Catatan Anda dapat merilis pembaruan ke aplikasi melalui Microsoft Store tanpa kehilangan file data kustom. Namun, jika pengguna menghapus aplikasi, file data kustom tidak lagi tersedia, bahkan jika pengguna menginstal ulang aplikasi.

Menguji data kustom untuk aplikasi yang telah diinstal sebelumnya

Aplikasi yang telah diinstal sebelumnya pada PC dapat mengakses data kustom khusus untuk penginstalan. Data kustom ini ditambahkan ke aplikasi selama pra-instalan dan tersedia untuk aplikasi saat runtime. Data kustom memungkinkan pengembang untuk menyesuaikan fitur dan fungsionalitas aplikasi, termasuk menyediakan kemampuan pelaporan.

File Custom.data muncul di lokasi aplikasi yang diinstal. Nama Custom.data dikodekan secara permanen dan tidak dapat dimodifikasi. Aplikasi Anda dapat memeriksa keberadaan file ini untuk menentukan apakah aplikasi telah diinstal sebelumnya di PC. Berikut adalah contoh cara mengakses file Custom.data.

var outputDiv = document.getElementById("CustomData");
Windows.ApplicationModel.Package.current.installedLocation.getFileAsync
     ("microsoft.system.package.metadata\\Custom.data").then(function (file) {
         // Read the file
         Windows.Storage.FileIO.readTextAsync(file).done(function (fileContent) {
            outputDiv.innerHTML = 
                 "App is preinstalled. CustomData contains:<br /><br />"
                 + fileContent;
         },
         function (error) {
             outputDiv.innerText = "Error reading CustomData " + error;
         });
     },
     function (error) {
         outputDiv.innerText = "CustomData was not available. App not preinstalled";
     });

File Custom.data Anda dapat menyertakan konten apa pun dan berada dalam format apa pun yang diperlukan aplikasi Anda. Proses penginstalan sebelumnya hanya membuatnya tersedia untuk aplikasi Anda. Pengembang dapat menyediakan file data ke mitra pra-instalan, atau Anda dapat menyetujui format yang memungkinkan mitra untuk menghasilkan konten.

Menguji data kustom Anda

Saat membuat dan men-debug aplikasi di Microsoft Visual Studio, Anda tidak dapat mengakses file Custom.data dari lokasi aplikasi yang diinstal karena aplikasi belum diinstal sebelumnya. Anda dapat mensimulasikan menggunakan file Custom.data dengan menguji file Custom.data di aplikasi itu sendiri, lalu memuat dan menguji file lokal aplikasi. Untuk melakukan ini, ubah sampel kode dari:

("microsoft.system.package.metadata\\Custom.data").then(function (file) {

ke:

("Custom.data").then(function (file) {

Setelah memverifikasi format dan konten file, Anda dapat mengubah lokasi file Custom.data ke lokasi akhir, seperti yang ditunjukkan pada contoh asli di atas.

Untuk menguji file Custom.data Anda

Buka Prompt Perintah Alat Penyebaran, yang diinstal dengan Windows ADK, dengan hak istimewa administrator. Dari layar Mulai, ketik Lingkungan Alat Penyebaran dan Pencitraan, klik kanan ikon, dan pilih Jalankan sebagai Administrator.
Tambahkan aplikasi dengan file data kustom:
```
dism /online /Add-ProvisionedAppxPackage /PackagePath:.\CustomData_1.0.0.1_AnyCPU_Debug.appx /CustomDataPath:.\Test.txt /SkipLicense
```
Jika /PackagePath:.\CustomData_1.0.0.1_AnyCPU_Debug.appx menunjuk ke paket pengujian aplikasi lokal Anda, dan di mana /CustomDataPath:.\Test.txt menunjuk ke file Custom.data Anda. Ketahuilah bahwa nama file yang Anda berikan di sini tidak digunakan setelah data diinstal di aplikasi Anda.

Aplikasi ini sekarang memiliki petak peta di layar Mulai PC yang digunakan untuk menguji aplikasi. Aplikasi harus dapat mengakses file Custom.data. Jika penelusuran kesalahan tambahan diperlukan, lampirkan debugger setelah memulai aplikasi dari layar Mulai .

Catatan Anda mungkin diminta untuk keluar dan masuk lagi untuk melihat aplikasi di layar Mulai .
Setelah selesai menguji aplikasi, Anda harus menghapus paket yang telah diinstal sebelumnya untuk terus menggunakan lingkungan Dev Anda. Untuk menghapus paket yang telah diinstal sebelumnya menggunakan Windows PowerShell, Anda dapat menggunakan cmdlet Get-AppxPackage untuk memberikan nama paket aplikasi lengkap melalui alur ke cmdlet Remove-ProvisionedAppxPackage:

Get-AppxPackage *CustomData* | Remove-ProvisionedAppxPackage

Di mana *CustomData* bagian yang diketahui dari nama aplikasi Anda

Menginstal aplikasi perangkat Microsoft Store atau aplikasi broadband seluler

Anda dapat menginstal komponen yang diperlukan sebelumnya untuk aplikasi perangkat Microsoft Store atau aplikasi broadband seluler menggunakan platform Deployment Image Servicing and Management (DISM).

Catatan Artikel ini ditujukan untuk OEM, yang akan mendukung aplikasi perangkat Microsoft Store atau aplikasi broadband seluler di perangkat mereka.

Untuk setiap jenis aplikasi, dua hal harus diinstal sebelumnya untuk menyediakan aplikasi perangkat Microsoft Store atau aplikasi broadband seluler yang benar:

Aplikasi perangkat Microsoft Store, sudah terinstal sebelumnya:
1. Paket metadata perangkat
2. Aplikasi
Aplikasi broadband seluler Microsoft Store, sudah terinstal sebelumnya:
1. Paket metadata layanan
2. Aplikasi

Penting Meskipun paket metadata dan aplikasi yang sesuai diurai segera setelah proses OOBE selesai, pengguna mungkin dapat meluncurkan aplikasi sebelum paket metadata diurai. Dalam hal ini, pengguna akan melihat kesalahan akses ditolak. Untuk menghindari hal ini, terapkan paket metadata dan aplikasi ke gambar sistem.

Instal ulang metadata perangkat atau paket metadata layanan

Untuk menginstal metadata perangkat atau paket metadata layanan sebelumnya

Jika Anda telah menginstal aplikasi perangkat Microsoft Store sebelumnya, maka Anda seharusnya telah memperoleh paket metadata perangkat. Jika Anda telah menginstal aplikasi broadband seluler sebelumnya, maka Anda seharusnya memperoleh paket metadata layanan.

Catatan Paket metadata perangkat dan paket metadata layanan menggunakan ekstensi nama file yang sama (.devicemetadata-ms).
Salin metadata perangkat atau paket metadata layanan (file devicemetadata-ms) ke gambar sistem Anda di folder %ProgramData%\Microsoft\Windows\DeviceMetadataStore . Anda dapat melakukannya dengan salah satu cara berikut:
- Online sebelum menjalankan Sysprep
- Offline setelah menjalankan Sysprep dengan menggunakan DISM. Untuk melakukan ini:
  1. Pasang gambar offline untuk layanan.
```
Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline
```
  2. Salin file paket metadata ke penyimpanan metadata perangkat dari gambar yang dipasang. Misalnya, untuk menyalin file paket metadata 0ECF2029-2C6A-41AE-9E0A-63FFC9EAD877.devicemetadata-ms ke penyimpanan metadata perangkat, ProgramData\Microsoft\Windows\DeviceMetadataStore:
```
copy 0ECF2029-2C6A-41AE-9E0A-63FFC9EAD877.devicemetadata-ms C:\test\offline\ProgramData\Microsoft\Windows\DeviceMetadataStore
```
  3. Simpan perubahan dan lepaskan gambar.
```
dism /Unmount-Image /mountdir: c:\test\offline /commit
```
  Untuk informasi selengkapnya tentang layanan gambar offline, lihat Gambaran Umum DISM.

Untuk informasi selengkapnya tentang metadata layanan, lihat Metadata layanan.

Instal aplikasi perangkat Microsoft Store atau aplikasi broadband seluler

Untuk menginstal aplikasi perangkat Microsoft Store atau aplikasi broadband seluler

Pasang gambar offline untuk layanan.

Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline

Tambahkan aplikasi perangkat Microsoft Store atau aplikasi broadband seluler ke gambar.

dism /Image:<mounted folder> /Add-ProvisionedAppxPackage /FolderPath:<appxpackage path>

Simpan perubahan dan lepaskan gambar.

dism /Unmount-Image /mountdir: c:\test\offline /commit