Ekstensi Penerbitan

Berlaku untuk: Pusat Admin Windows, Pratinjau Pusat Admin Windows

Setelah mengembangkan ekstensi, Anda harus menerbitkannya dan membuatnya tersedia untuk diuji atau digunakan oleh orang lain. Dalam artikel ini, kami memperkenalkan beberapa opsi penerbitan bersama dengan langkah-langkah dan persyaratan tergantung pada audiens dan tujuan penerbitan Anda.

Opsi Penerbitan

Ada tiga opsi utama untuk sumber paket yang dapat dikonfigurasi yang didukung Pusat Admin Windows:

• Umpan NuGet Pusat Admin Windows publik Microsoft
• Umpan NuGet privat Anda sendiri
• Berbagi file lokal atau jaringan

Menerbitkan ke umpan ekstensi Pusat Admin Windows

Secara default, Pusat Admin Windows tersambung ke umpan NuGet yang dikelola oleh tim produk Pusat Admin Windows di Microsoft. Versi pratinjau awal ekstensi baru yang dikembangkan oleh Microsoft dapat diterbitkan ke umpan ini dan tersedia untuk pengguna Pusat Admin Windows. Pengembang eksternal yang berencana untuk membangun dan merilis ekstensi secara publik juga dapat mengirimkan permintaan untuk Menerbitkan ekstensi Anda ke umpan Pusat Admin Windows. Sebelum menerbitkan ke umpan ini, pengembang eksternal harus menyetujui Perjanjian Penerbit Ekstensi dan Kebijakan Partisipasi Ekstensi Pusat Admin Windows.

Menerbitkan ke umpan NuGet yang berbeda

Anda juga dapat membuat umpan NuGet Anda sendiri untuk menerbitkan ekstensi Anda untuk menggunakan salah satu dari banyak opsi berbeda untuk menyiapkan sumber privat atau menggunakan layanan hosting NuGet. Umpan NuGet harus mendukung API NuGet v2. Karena Pusat Admin Windows saat ini tidak mendukung autentikasi umpan, umpan perlu dikonfigurasi untuk mengizinkan akses baca kepada siapa pun.

Menerbitkan ke berbagi file

Untuk membatasi akses ekstensi Anda ke organisasi Anda atau ke sekelompok orang terbatas, Anda bisa menggunakan berbagi file SMB sebagai umpan ekstensi. Saat menggunakan berbagi file untuk menghosting umpan ekstensi Anda, izin file dan folder diterapkan untuk mengelola akses ke umpan.

Menyiapkan ekstensi Anda untuk rilis

Pastikan Anda membaca dan mempertimbangkan artikel pengembangan berikut:

• Mengontrol visibilitas alat Anda
• String dan pelokalan

Pertimbangkan untuk merilis sebagai rilis Pratinjau

Jika Anda merilis versi pratinjau ekstensi Anda untuk tujuan evaluasi, kami sarankan Anda:

• Tambahkan "(Pratinjau)" ke akhir judul ekstensi Anda dalam .nuspec file
• Menjelaskan batasan dalam deskripsi ekstensi Anda dalam .nuspec file

Membuat paket ekstensi

Pusat Admin Windows menggunakan paket dan umpan NuGet untuk mendistribusikan dan mengunduh ekstensi. Agar paket Anda dikirim, Anda perlu membuat paket NuGet yang berisi plugin dan ekstensi Anda. Satu paket dapat berisi ekstensi UI dan plugin Gateway. Bagian berikut memandikan Anda melalui proses.

Membangun ekstensi Anda

Segera setelah Anda siap untuk mulai mengemas ekstensi Anda, buat direktori baru di sistem file Anda, buka konsol, lalu CD ke dalamnya. Direktori ini adalah direktori akar yang kami gunakan untuk berisi semua direktori nuspec dan konten yang membentuk paket kami. Kami menyebut folder ini Paket NuGet untuk sisa artikel ini.

Ekstensi UI

Untuk memulai proses pengumpulan semua konten yang diperlukan untuk ekstensi UI, jalankan "build gulp" pada alat Anda dan pastikan build berhasil. Proses ini mengemas semua komponen bersama-sama dalam folder yang disebut "bundel" yang terletak di direktori akar ekstensi Anda (pada tingkat direktori src yang sama). Salin direktori ini dan semua isinya ke dalam folder "Paket NuGet".

Plugin Gateway

Menggunakan infrastruktur build Anda (yang bisa sesering membuka Visual Studio dan memilih tombol Build), kompilasi dan buat plugin Anda. Buka direktori output build Anda, salin DLL atau DLL yang mewakili plugin Anda dan letakkan di folder baru di dalam direktori "Paket NuGet" yang disebut "paket". Anda tidak perlu menyalin DLL FeatureInterface, hanya DLL atau DLL yang mewakili kode Anda.

Membuat file nuspec

Untuk membuat paket NuGet, Anda harus terlebih dahulu membuat .nuspec file. File .nuspec adalah manifes XML yang berisi metadata paket NuGet. Manifes ini digunakan baik untuk membangun paket maupun untuk memberikan informasi kepada konsumen. Tempatkan file ini di akar folder "Paket NuGet".

Berikut adalah contoh .nuspec file dan daftar properti yang diperlukan atau direkomendasikan. Untuk skema lengkap, lihat referensi nuspec. Simpan file ke .nuspec folder akar proyek Anda menggunakan nama file pilihan Anda.

Penting

Nilai <id> dalam .nuspec file perlu mencocokkan "name" nilai dalam file proyek manifest.json Anda, atau ekstensi yang diterbitkan tidak akan berhasil dimuat di Pusat Admin Windows.

<?xml version="1.0">
<package>
  <metadata>
    <id>contoso.project.extension</id>
    <version>1.0.0</version>
    <title>Contoso Hello Extension</title>
    <authors>Contoso</authors>
    <owners>Contoso</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <projectUrl>https://msft-sme.myget.org/feed/windows-admin-center-feed/package/nuget/contoso.sme.hello-extension</projectUrl>
    <licenseUrl>http://YourLicenseLink</licenseUrl>
    <iconUrl>http://YourLogoLink</iconUrl>
    <description>Hello World extension by Contoso</description>
    <copyright>(c) Contoso. All rights reserved.</copyright>
    <tags></tags>
  </metadata>
  <files>
    <file src="bundle\**\*.*" target="ux" />
    <file src="package\**\*.*" target="gateway" />
  </files>
</package>

Properti yang Diperlukan atau Yang Direkomendasikan

Nama Properti	Diperlukan / Disarankan	Deskripsi
packageType	Wajib	Gunakan WindowsAdminCenterExtension, yang merupakan jenis paket NuGet yang ditentukan untuk ekstensi Pusat Admin Windows.
ID	Wajib	Pengidentifikasi Paket Unik dalam umpan. Nilai ini perlu cocok dengan nilai "nama" dalam file manifest.json proyek Anda. Lihat Memilih pengidentifikasi paket unik untuk panduan.
title	Diperlukan untuk menerbitkan ke umpan Pusat Admin Windows	Nama yang mudah diingat untuk paket yang ditampilkan di Pengelola Ekstensi Pusat Admin Windows.
versi	Wajib	Versi ekstensi. Menggunakan Penerapan Versi Semantik (konvensi SemVer) disarankan tetapi tidak diperlukan.
penulis	Wajib	Jika menerbitkan atas nama perusahaan Anda, gunakan nama perusahaan Anda.
description	Wajib diisi	Berikan deskripsi fungsionalitas ekstensi.
iconUrl	Disarankan saat menerbitkan ke umpan Pusat Admin Windows	URL untuk ikon yang akan ditampilkan di Pengelola Ekstensi.
projectUrl	Diperlukan untuk menerbitkan ke umpan Pusat Admin Windows	URL ke situs web ekstensi Anda. Jika Anda tidak memiliki situs web terpisah, gunakan URL untuk halaman web paket di umpan NuGet.
licenseUrl	Diperlukan untuk menerbitkan ke umpan Pusat Admin Windows	URL ke perjanjian lisensi pengguna akhir ekstensi Anda.
file	Wajib	Kedua pengaturan ini menyiapkan struktur folder yang diharapkan Pusat Admin Windows untuk ekstensi UI dan plugin Gateway.

Membangun paket NuGet ekstensi

Dengan menggunakan file yang .nuspec Anda buat, Anda sekarang perlu membuat file paket .nupkg NuGet, yang dapat Anda unggah dan terbitkan ke umpan NuGet.

1. Unduh alat nuget.exe CLI dari situs web alat klien NuGet.
2. Jalankan nuget.exe pack <>.nuspec file name> untuk membuat file .nupkg.

Menandatangani paket NuGet ekstensi Anda

File apa pun .dll yang disertakan dalam ekstensi Anda harus ditandatangani dengan sertifikat dari Otoritas Sertifikat (CA) tepercaya. Secara default, file yang tidak ditandatangani .dll diblokir agar tidak dijalankan saat Pusat Admin Windows berjalan dalam Mode Produksi.

Kami menyarankan agar Anda menandatangani paket NuGet ekstensi untuk memastikan integritas paket.

Catatan

Jika Anda berencana pada ekstensi yang mendukung Kontrol Aplikasi Pertahanan Windows, paket Anda dan semua file di dalamnya harus ditandatangani. Pelajari selengkapnya tentang penandatanganan dengan Kontrol Aplikasi Pertahanan Windows.

Menguji paket NuGet ekstensi Anda

Paket ekstensi Anda sekarang siap untuk pengujian! .nupkg Unggah file ke umpan NuGet atau salin ke berbagi file. Untuk melihat dan mengunduh paket dari umpan atau berbagi file yang berbeda, Anda perlu mengubah konfigurasi umpan untuk menunjuk ke umpan NuGet atau berbagi file Anda. Saat menguji, pastikan properti ditampilkan dengan benar di Extension Manager, dan Anda dapat berhasil menginstal dan menghapus instalan ekstensi Anda.

Menerbitkan ekstensi Anda ke umpan Pusat Admin Windows

Dengan menerbitkan ke umpan Pusat Admin Windows, Anda dapat membuat ekstensi Anda tersedia untuk pengguna Pusat Admin Windows mana pun. Karena Windows Admin Center SDK masih dalam pratinjau, kami ingin bekerja sama dengan Anda untuk membantu menyelesaikan masalah pengembangan dan membantu Anda memberikan produk dan pengalaman berkualitas kepada pengguna Anda.

Sebelum mengirimkan permintaan tinjauan ekstensi ke Microsoft, Anda harus mengirim email untuk wacextensionrequest@microsoft.com mengekspresikan niat untuk menerbitkan ekstensi ke umpan publik. Kami memberi Anda salinan Perjanjian Penerbit Ekstensi dan Kebijakan Partisipasi Ekstensi untuk meninjau dan mengakui secara tertulis.

Sebelum merilis versi awal ekstensi Anda, kami sarankan Anda mengirimkan permintaan tinjauan ekstensi ke Microsoft setidaknya 2-3 minggu sebelum rilis. Mengizinkan 2-3 minggu sebelum rilis memastikan kami memiliki cukup waktu untuk meninjau dan bagi Anda untuk membuat perubahan pada ekstensi Anda jika perlu. Setelah ekstensi Anda siap diterbitkan, Anda harus mengirimkannya kepada kami untuk ditinjau. Jika ekstensi Anda disetujui, kami menerbitkannya ke umpan untuk Anda. Dengan mengirim paket ekstensi Anda kepada Microsoft, Anda setuju untuk terikat oleh ketentuan Perjanjian Penerbit Ekstensi dan Kebijakan Partisipasi Ekstensi.

Setelah itu, jika Anda ingin merilis pembaruan ke ekstensi, Anda perlu mengirimkan permintaan lain untuk ditinjau. Bergantung pada cakupan perubahan, waktu penyelesaian untuk tinjauan pembaruan umumnya lebih pendek.

Mengirimkan permintaan tinjauan ekstensi ke Microsoft

Untuk mengirimkan permintaan tinjauan ekstensi, berikan informasi berikut dan kirim sebagai email ke wacextensionrequest@microsoft.com. Kami membalas email Anda dalam seminggu.

Pusat Admin Windows - Informasi permintaan tinjauan ekstensi:

• Nama dan alamat email pemilik/pengembang ekstensi (hingga 3 pengguna). Jika Anda merilis ekstensi atas nama perusahaan Anda, berikan alamat email perusahaan Anda.
• Nama perusahaan (Hanya diperlukan jika Anda merilis ekstensi atas nama perusahaan Anda)
• Nama ekstensi
• Tanggal target rilis (perkiraan)
• Untuk pengiriman ekstensi baru - Deskripsi ekstensi (bingkai kawat desain awal, mockup layar, atau cuplikan layar produk yang direkomendasikan)
• Untuk tinjauan pembaruan ekstensi – Deskripsi perubahan (sertakan cuplikan layar produk jika UI berubah secara signifikan)

Kirim paket ekstensi Anda untuk peninjauan dan penerbitan

Pastikan Anda mengikuti instruksi sebelumnya untuk membuat paket ekstensi dan .nuspec file didefinisikan dengan benar dan file ditandatangani. Kami juga menyarankan agar Anda memiliki situs web proyek termasuk:

• Deskripsi terperinci tentang ekstensi Anda termasuk cuplikan layar atau video
• Alamat email atau fitur situs web untuk menerima umpan balik atau pertanyaan

Saat Anda siap untuk menerbitkan ekstensi Anda, kirim email ke wacextensionrequest@microsoft.com. Kami memberikan instruksi tentang cara mengirimi kami paket ekstensi Anda. Setelah kami menerima paket Anda, kami akan meninjaunya. Setelah paket ekstensi Anda disetujui, kami akan menerbitkan ke umpan Pusat Admin Windows.