Menyusun dan menyebarkan aplikasi mitra

Bagian ini menjelaskan cara menyusun, mengemas, dan menyebarkan aplikasi mitra Azure Sphere.

Instruksi ini menggunakan aplikasi sampel IntercoreComms sebagai contoh.

Prasyarat

• Menyambungkan perangkat Azure Sphere ke komputer Anda
• Menginstal Azure Sphere
• Instal toolchain GNU Arm Embedded jika Anda menggunakan Visual Studio Code atau CLI.
• Menyiapkan perangkat keras untuk menampilkan output dari UART khusus, jika Anda belum melakukannya

Mengaktifkan pengembangan dan proses debug

Sebelum dapat membuat aplikasi sampel di perangkat Azure Sphere atau mengembangkan aplikasi baru untuk aplikasi tersebut, Anda harus mengaktifkan pengembangan dan proses debug. Secara default, perangkat Azure Sphere "terkunci"; yaitu, mereka tidak mengizinkan aplikasi yang sedang dikembangkan untuk dimuat dari PC, dan mereka tidak mengizinkan debugging aplikasi. Mempersiapkan perangkat untuk proses debug akan menghapus batasan ini dan memuat perangkat lunak yang diperlukan untuk men-debugging dan membuka kunci kemampuan perangkat .

Untuk melakukan debug pada inti real-time, gunakan perintah pengembangan aktifkan perangkat bola az . Perintah ini mengonfigurasi perangkat untuk menerima aplikasi dari PC untuk proses debug dan menetapkan perangkat ke grup Perangkat pengembangan, yang tidak mengizinkan pembaruan aplikasi cloud. Selama pengembangan dan debugging aplikasi, Anda harus meninggalkan perangkat dalam grup ini sehingga pembaruan aplikasi cloud tidak menimpa aplikasi yang sedang dikembangkan.

Di Windows, Anda harus menambahkan --enable-rt-core-debugging parameter, yang memuat server debugging dan driver yang diperlukan untuk setiap tipe inti ke perangkat.

Windows

1. Masuk ke Azure Sphere jika Anda belum melakukannya:

   az login
   

2. Buka antarmuka baris perintah menggunakan PowerShell atau Prompt Perintah Windows dengan hak istimewa administrator. Parameter --enable-rt-core-debugging memerlukan hak istimewa administrator karena menginstal driver USB untuk debugger.

3. Masukkan perintah berikut:

   az sphere device enable-development --enable-rt-core-debugging  --catalog <CatalogName>  --resource-group <ResourceGroupName>
   

4. Tutup jendela setelah perintah selesai karena hak istimewa administrator tidak lagi diperlukan. Sebagai praktik terbaik, Anda harus selalu menggunakan hak istimewa terendah yang dapat menyelesaikan tugas.

Linux

1. Masuk ke Azure Sphere jika Anda belum melakukannya:

   az login
   

2. Masukkan perintah berikut:

   az sphere device enable-development --enable-rt-core-debugging  --catalog <CatalogName> --resource-group <ResourceGroupName>
   

Jika perintah pengembangan mengaktifkan perangkat bola az gagal, lihat Memecahkan masalah Azure Sphere untuk bantuan.

Mengaktifkan pengembangan dan proses debug

Sebelum dapat membuat aplikasi sampel di perangkat Azure Sphere atau mengembangkan aplikasi baru untuk aplikasi tersebut, Anda harus mengaktifkan pengembangan dan proses debug. Secara default, perangkat Azure Sphere "terkunci"; yaitu, mereka tidak mengizinkan aplikasi yang sedang dikembangkan untuk dimuat dari PC, dan mereka tidak mengizinkan debugging aplikasi. Mempersiapkan perangkat untuk proses debug akan menghapus batasan ini dan memuat perangkat lunak yang diperlukan untuk melakukan debug dan membuka kunci kemampuan perangkat seperti yang dijelaskan dalam Kapabilitas perangkat dan komunikasi.

Untuk melakukan debug pada inti real-time, gunakan perintah pengembangan aktifkan perangkat bola az . Perintah ini mengonfigurasi perangkat untuk menerima aplikasi dari PC untuk proses debug dan menetapkan perangkat ke grup Perangkat pengembangan, yang tidak mengizinkan pembaruan aplikasi cloud. Selama pengembangan dan debugging aplikasi, Anda harus meninggalkan perangkat dalam grup ini sehingga pembaruan aplikasi cloud tidak menimpa aplikasi yang sedang dikembangkan.

Di Windows, Anda harus menambahkan --enable-rt-core-debugging parameter, yang memuat server debugging dan driver yang diperlukan untuk setiap tipe inti ke perangkat.

1. Masuk ke Azure jika Anda belum melakukannya:

   az login
   

2. Buka antarmuka baris perintah menggunakan PowerShell, Prompt Perintah Windows, atau shell perintah Linux dengan hak istimewa administrator. Parameter --enable-rt-core-debugging memerlukan hak istimewa administrator karena menginstal driver USB untuk debugger.

3. Masukkan perintah berikut:

   az sphere device enable-development --enable-rt-core-debugging
   

4. Tutup jendela setelah perintah selesai karena hak istimewa administrator tidak lagi diperlukan. Sebagai praktik terbaik, Anda harus selalu menggunakan hak istimewa terendah yang dapat menyelesaikan tugas.

Jika perintah pengembangan mengaktifkan perangkat bola az gagal dengan pesan kesalahan berikut, lihat Memecahkan masalah Azure Sphere untuk bantuan.

error: The device did not accept the device capability configuration. Please check the Azure Sphere OS on your device is up-to-date using 'az sphere device show-deployment-status'.

Menyusun aplikasi mitra dengan Visual Studio

1. Pastikan perangkat Anda tersambung ke PC menggunakan USB. Dalam menu Atur item mulai , pilih Aplikasi Azure Sphere (Semua Inti) di mana Aplikasi Azure Sphere adalah nama proyek tingkat atas Anda atau tekan F5.

   

2. Jika Diminta untuk menyusun proyek, pilih Ya. Visual Studio mengumpulkan aplikasi mitra, membuat paket gambar, memuat sisinya ke papan, dan memulainya dalam mode debug. Muat sisi berarti bahwa aplikasi dikirim langsung dari PC melalui koneksi berkabel, daripada dikirim melalui cloud.

   Perhatikan jalur dalam output TampilkanOutput>Tampilkan>dari: Output build, yang menunjukkan lokasi paket gambar output di PC Anda. Jika sudah siap untuk membuat penyebaran, Anda perlu mengetahui jalur ke paket gambar.

3. Secara default, jendela Output memperlihatkan output dari Output Perangkat. Untuk melihat pesan dari debugger, pilih Debug dari menu menurun Perlihatkan output dari: . Anda juga dapat memeriksa pembongkaran, pendaftaran, atau memori program melalui menu Debug>Windows .

Membuat aplikasi mitra dengan Visual Studio Code

1. Buka folder yang berisi aplikasi mitra Anda. Visual Studio Code mendeteksi file ruang kerja dan menanyakan apakah Anda ingin membuka ruang kerja. Pilih Buka Ruang Kerja untuk membuka aplikasi real-time dan aplikasi tingkat tinggi sekaligus.

2. Klik kanan salah satu dari dua file CMakeLists.txt dan pilih Susun Semua Proyek.

3. Klik ikon Jalankan di Bilah Aktivitas Visual Studio Code.

4. Pada menu tarik turun yang muncul di bagian atas jendela di sisi kiri layar, pilih Luncurkan Aplikasi Azure Sphere (gdb)(ruang kerja).

5. Tekan F5 untuk menyusun dan men-debug proyek. Jika proyek belum dibuat sebelumnya, atau jika file telah diubah dan dibuat ulang diperlukan, Visual Studio Code akan membuat proyek sebelum proses debug dimulai.

6. Tunggu beberapa detik hingga Visual Studio Code menyusun aplikasi, membuat paket gambar, menyebarkannya ke papan, dan memulainya dalam mode debug. Anda akan melihat pembaruan status di panel Output di sepanjang jalan.

   Pertama, CMake menentukan apakah aplikasi perlu dibuat. Jika demikian, fokus bergeser ke jendela output, yang menampilkan output dari CMake/Build.

   Berikutnya, panel output memperlihatkan output saat menyebarkan paket gambar ke perangkat. Akhirnya, Konsol Debug menerima fokus dan memperlihatkan output gdb.

Menyusun dan menyusun aplikasi

Untuk membuat aplikasi dengan CLI, Anda harus menemukan alat kompilasi, header, dan pustaka yang benar—secara kolektif disebut sysroot—di komputer Anda. SDK Azure Sphere dikirim dengan beberapa sysroot sehingga aplikasi dapat menargetkan kumpulan API yang berbeda, seperti yang dijelaskan dalam Versi runtime aplikasi, sysroot, dan API Beta. Sysroot diinstal di folder penginstalan Azure Sphere SDK di bawah Sysroots.

Saat membuat dengan CLI, pertama-tama buat dan sebarkan aplikasi yang berkemampuan real-time, lalu buat dan sebarkan aplikasi tingkat tinggi.

Membuat dan menyebarkan aplikasi yang berkemampuan real-time

1. Navigasikan ke folder yang berisi aplikasi berkemampuan real-time Anda.

2. Buka file app_manifest.json dan verifikasi bahwa ID komponen aplikasi tingkat tinggi ditampilkan dalam kapabilitas AllowedApplicationConnections.

3. Buka antarmuka baris perintah menggunakan PowerShell, Windows Command Prompt, atau shell perintah Linux. Navigasikan ke direktori build proyek Anda.

4. Dari direktori build proyek Anda, di prompt perintah, jalankan CMake dengan parameter berikut:

   cmake --preset <preset-name> <source-path>
   

   • --preset <preset-name>

     Nama prasetel konfigurasi build seperti yang ditentukan dalam CMakePresets.json.

   • --build <cmake-path>

     Direktori biner yang berisi singgahan CMake. Misalnya, jika Anda menjalankan CMake di sampel Azure Sphere, perintah build adalah cmake --build out/ARM-Debug.

   • <source-path>

     Jalur direktori yang berisi file sumber untuk aplikasi sampel. Dalam contoh, penyimpanan sampel Azure Sphere diunduh ke direktori yang disebut AzSphere.

     Parameter CMake dipisahkan oleh spasi. Karakter kelanjutan baris (^ untuk baris perintah Windows, \ untuk baris perintah Linux, atau ' untuk PowerShell) dapat digunakan untuk keterbacaan, tetapi tidak diperlukan.

   Contoh berikut ini memperlihatkan perintah CMake untuk IntercoreComms RTApp:

   Windows

   Prompt Perintah Windows

   cmake ^
   --preset "ARM-Debug" ^
   "C:\AzSphere\azure-sphere-samples\Samples\IntercoreComms\IntercoreComms_RTApp_MT3620_BareMetal"
   

   Windows PowerShell

   cmake `
   --preset "ARM-Debug" `
   "C:\AzSphere\azure-sphere-samples\Samples\IntercoreComms\IntercoreComms_RTApp_MT3620_BareMetal"
   

   Linux

   cmake \
   --preset "ARM-Debug" \
   ./AzSphere/azure-sphere-samples/Samples/IntercoreComms/IntercoreComms_RTApp_MT3620_BareMetal
   

5. Dari direktori build proyek Anda, di prompt perintah, jalankan Ninja untuk membuat aplikasi dan membuat file paket gambar.

   ninja -C out/ARM-Debug
   

   Ninja menempatkan aplikasi yang dihasilkan dan file .imagepackage dalam direktori yang ditentukan.

   Anda juga dapat memanggil Ninja melalui CMake dengan perintah berikut:

   cmake --build out/<binary-dir>
   

   Atur <binary-dir> ke direktori biner yang berisi singgahan CMake. Misalnya, jika Anda menjalankan CMake di sampel Azure Sphere, perintah build adalah cmake --build out/ARM-Debug.

   Saat memecahkan masalah, terutama setelah membuat perubahan pada perintah CMake, hapus seluruh build, lalu coba lagi.

6. Hapus aplikasi apa pun yang sudah disebarkan ke perangkat:

   az sphere device sideload delete
   

7. Dari direktori build proyek Anda, di prompt perintah, muat paket gambar yang dibuat Ninja:

   az sphere device sideload deploy --image-package <path-to-imagepackage>
   

   Aplikasi akan mulai berjalan segera setelah dimuat.

8. Dapatkan ID komponen untuk gambar:

   az sphere image-package show --image-package <path-to-imagepackage>
   

   Perintah mengembalikan semua metadata untuk paket gambar. ID komponen untuk aplikasi muncul di bagian Identitas untuk Tipe Gambar Aplikasi. Misalnya:

   ...
     "Identity": {
       "ComponentId": "<component-id>",
       "ImageId": "<image-id>",
       "ImageType": "Application"
     },
   ...
   

Menyusun dan menyebarkan aplikasi tingkat tinggi

1. Navigasikan ke folder yang berisi aplikasi tingkat tinggi Anda.

2. Buka file app_manifest.json dan verifikasi bahwa ID komponen RTApp ditampilkan dalam kapabilitas AllowedApplicationConnections.

3. Buka antarmuka baris perintah menggunakan PowerShell, Windows Command Prompt, atau shell perintah Linux. Navigasikan ke direktori build proyek Anda.

4. Dari direktori build proyek Anda, di prompt perintah, jalankan CMake dengan parameter berikut:

   cmake --preset <preset-name> <source-path>
   

   • --preset <preset-name>

     Nama prasetel konfigurasi build seperti yang ditentukan dalam CMakePresets.json.

   • --build <cmake-path>

     Direktori biner yang berisi singgahan CMake. Misalnya, jika Anda menjalankan CMake di sampel Azure Sphere, perintah build adalah cmake --build out/ARM-Debug.

   • <source-path>

     Jalur direktori yang berisi file sumber untuk aplikasi sampel. Dalam contoh, penyimpanan sampel Azure Sphere diunduh ke direktori yang disebut AzSphere.

     Parameter CMake dipisahkan oleh spasi. Karakter kelanjutan baris (^ untuk baris perintah Windows, \ untuk baris perintah Linux, atau ' untuk PowerShell) dapat digunakan untuk keterbacaan, tetapi tidak diperlukan.

   Contoh berikut ini memperlihatkan perintah CMake untuk aplikasi tingkat tinggi IntercoreComms.

   Windows

   Prompt Perintah Windows

   cmake ^
   --preset "ARM-Debug" ^
   "C:\AzSphere\azure-sphere-samples\Samples\IntercoreComms\IntercoreComms_HighLevelApp"
   

   Windows PowerShell

   cmake `
   --preset "ARM-Debug" `
   "C:\AzSphere\azure-sphere-samples\Samples\IntercoreComms\IntercoreComms_HighLevelApp"
   

   Linux

   cmake \
   --preset "ARM-Debug" \
   ./AzSphere/azure-sphere-samples/Samples/IntercoreComms/IntercoreComms_HighLevelApp
   

5. Dari direktori build proyek Anda, di prompt perintah, jalankan Ninja untuk membuat aplikasi dan membuat file paket gambar.

   ninja -C out/ARM-Debug
   

   Ninja menempatkan aplikasi yang dihasilkan dan file .imagepackage dalam direktori yang ditentukan.

   Anda juga dapat memanggil Ninja melalui CMake dengan perintah berikut:

   cmake --build out/<binary-dir>
   

   Atur <binary-dir> ke direktori biner yang berisi singgahan CMake. Misalnya, jika Anda menjalankan CMake di sampel Azure Sphere, perintah build adalah cmake --build out/ARM-Debug.

   Saat memecahkan masalah, terutama setelah membuat perubahan pada perintah CMake, hapus seluruh build, lalu coba lagi.

6. Dari direktori build proyek Anda, di prompt perintah, muat paket gambar yang dibuat Ninja:

   az sphere device sideload deploy --image-package <package-name>
   

   Aplikasi akan mulai berjalan segera setelah dimuat.

7. Dapatkan ID komponen untuk gambar:

   az sphere image-package show --image-package <path-to-imagepackage>
   

   Perintah mengembalikan semua metadata untuk paket gambar. ID komponen untuk aplikasi muncul di bagian Identitas untuk Tipe Gambar Aplikasi. Misalnya:

     "ComponentId": "<component-ID>",
   ...
     "Identity": {
       "ComponentId": "<component-id>",
       "ImageId": "<image-id>",
       "ImageType": "Application"
     },
   ...