Instal aplikasi sebelumnya menggunakan DISM

Catatan

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

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

Tip

Hardware Support Apps (HSA) adalah Microsoft Store Apps, 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 opsi ./region Saat menginstal aplikasi sebelumnya, Anda dapat memilih untuk meninggalkan aplikasi dari LayoutModification.xml dan aplikasi akan berhasil diinstal tanpa muncul sebagai petak Menu Mulai. Saat daftar wilayah TIDAK ditentukan, aplikasi akan disediakan hanya jika disematkan untuk memulai tata letak.

Mengekstrak file paket

  1. Telusuri ke folder tempat Anda menyimpan paket aplikasi yang Anda unduh dari Dasbor Mitra.

  2. 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 tidak dikemas.

Instal aplikasi yang ditandatangani Microsoft Store sebelumnya dengan DISM

  1. Buka Prompt Perintah sebagai administrator.

  2. Pasang gambar Windows untuk yang ingin Anda layanan:

    Dism /Mount-Image /ImageFile:c:\images\myimage.wim /Index:1 /mountdir:c:\test\offline
    
  3. 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..

  4. Sematkan aplikasi ke Menu Mulai.

  5. Simpan perubahan dan lepaskan gambar. Di prompt perintah, ketik:

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

Catatan

Microsoft Store aplikasi 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 sebelumnya, Anda harus memasukkan kartu SIM di PC sebelum menjalankan fase khusus Sysprep. Untuk informasi selengkapnya tentang menginstal aplikasi perangkat broadband seluler sebelumnya, lihat Menginstal Komponen yang Diperlukan sebelumnya 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

  1. Buka 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.

  2. Pasang gambar offline untuk layanan. Di prompt perintah, ketik:

    Dism /Mount-Image /ImageFile:c:\images\myimage.wim /Index:1 /mountdir:c:\test\offline
    
  3. Temukan nama paket lengkap aplikasi yang ingin Anda hapus. Di prompt perintah, ketik:

    Dism /Image:C:\test\offline /Get-ProvisionedAppxPackages
    
  4. 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
    
  5. Jika ingin memperbarui aplikasi, Anda dapat menginstal versi terbaru aplikasi yang ditandatangani Microsoft Store. Pada prompt perintah, ketik:

    Dism /Image:c:\test\offline /Add-ProvisionedAppxPackage/FolderPath:c:\downloads\appxpackage
    
  6. Simpan perubahan dan lepaskan gambar. Di 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 prainstalan 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 akan 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 prainstalan 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 dalam format apa pun yang diperlukan aplikasi Anda. Proses pra-instalan 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

  1. Buka 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.

  2. Tambahkan aplikasi dengan file data kustom:

    dism /online /Add-ProvisionedAppxPackage /PackagePath:.\CustomData_1.0.0.1_AnyCPU_Debug.appx /CustomDataPath:.\Test.txt /SkipLicense
    

    Di mana /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 diharuskan untuk keluar dan masuk lagi untuk melihat aplikasi di layar Mulai .

  3. 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* adalah 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:

  • Microsoft Store aplikasi perangkat, instalan sebelumnya:
    1. Paket metadata perangkat
    2. Aplikasi
  • Microsoft Store aplikasi broadband seluler, pra-instal:
    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

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

    Catatan Paket metadata perangkat dan paket metadata layanan menggunakan ekstensi nama file yang sama (.devicemetadata-ms).

  2. 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

  1. Pasang gambar offline untuk layanan.

    Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline
    
  2. Tambahkan aplikasi perangkat Microsoft Store atau aplikasi broadband seluler ke gambar.

    dism /Image:<mounted folder> /Add-ProvisionedAppxPackage /FolderPath:<appxpackage path>
    
  3. Simpan perubahan dan lepaskan gambar.

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