Membuat aplikasi tingkat tinggi

Penting

Ini adalah dokumentasi Azure Sphere (Warisan). Azure Sphere (Warisan) dihentikan pada 27 September 2027, dan pengguna harus bermigrasi ke Azure Sphere (Terintegrasi) saat ini. Gunakan pemilih Versi yang terletak di atas TOC untuk melihat dokumentasi Azure Sphere (Terintegrasi).

Cara termampu untuk membuat aplikasi tingkat tinggi baru adalah dengan memulai dengan templat Kosong dari ekstensi Visual Studio Code Azure Sphere dan menyesuaikan konfigurasi ke proyek Anda dengan mengikuti langkah-langkah berikut:

1. Memulai Visual Studio Code. Pilih Tampilkan>Palet Perintah, lalu ketik Azure Sphere: Hasilkan Proyek Baru.

   

2. Pilih HL Kosong dari menu Templat.

   

3. Visual Studio Code kemudian menampilkan jendela File Explorer . Navigasi ke folder tempat Anda ingin menempatkan aplikasi Kosong dan tentukan nama untuk proyek Anda, misalnya, NewHLApp. Visual Studio Code membuat folder NewHLApp di lokasi yang Anda pilih dan menghasilkan file build untuk aplikasi kosong. Anda akan melihat pesan dari CMake.

4. Buka file CMakeLists.txt dan tentukan folder yang berisi definisi untuk perangkat keras yang Anda gunakan. Secara default, aplikasi HL Blank tidak berisi definisi perangkat keras. Anda dapat menemukan contoh definisi perangkat keras di repositori Sampel Azure Sphere atau membuatnya seperti yang dijelaskan dalam Definisi perangkat keras.

   Berikut ini menunjukkan cara menambahkan contoh definisi perangkat keras untuk Kit Pengembangan Azure Sphere MT3620 yang Dilihat:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Baris ini harus disisipkan sebelum perintah akhir dimulai azsphere_target_add_image_package.

Anda juga dapat membuat aplikasi tingkat tinggi baru dari salah satu sampel Azure Sphere tingkat tinggi:

1. Kloning repositori sampel jika Anda belum melakukannya. Salin salah satu folder aplikasi tingkat tinggi dan ganti namanya untuk proyek Anda.

2. Dalam file CMakeLists.txt, ubah nama proyek menjadi nama folder baru Anda. Contohnya:

   PROJECT(NewHLApp C)

Cara termampu untuk membuat aplikasi tingkat tinggi baru adalah dengan memulai dengan templat Kosong dari ekstensi Visual Studio Azure Sphere dan menyesuaikan konfigurasi ke proyek Anda dengan mengikuti langkah-langkah berikut:

1. Mulai Visual Studio dan pilih Buat proyek baru.

2. Ketik Azure Sphere di kotak pencarian berlabel Cari templat. Pilih Azure Sphere HLCore Kosong dari daftar yang dikembalikan, lalu pilih Berikutnya.

3. Tentukan nama proyek (misalnya, NewHLApp), lokasi file proyek, dan nama solusi (yang bisa sama dengan nama proyek), lalu pilih Buat. Visual Studio membuat folder NewHLpp di lokasi yang Anda pilih dan menghasilkan file build untuk aplikasi kosong. Anda akan melihat pesan dari CMake.

4. Buka file CMakeLists.txt dan tentukan folder yang berisi definisi untuk perangkat keras yang Anda gunakan. Secara default, aplikasi HL Blank tidak berisi definisi perangkat keras. Anda dapat menemukan contoh definisi perangkat keras di repositori Sampel Azure Sphere atau membuatnya seperti yang dijelaskan dalam Definisi perangkat keras.

   Berikut ini menunjukkan cara menambahkan contoh definisi perangkat keras untuk Kit Pengembangan Azure Sphere MT3620 yang Dilihat:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Baris ini harus disisipkan sebelum perintah akhir dimulai azsphere_target_add_image_package.

Anda juga dapat membuat aplikasi tingkat tinggi baru dari salah satu sampel Azure Sphere tingkat tinggi:

1. Kloning repositori sampel jika Anda belum melakukannya. Salin salah satu folder aplikasi tingkat tinggi dan ganti namanya untuk proyek Anda.

2. Dalam file CMakeLists.txt, ubah nama proyek menjadi nama folder baru Anda. Contohnya:

   PROJECT(NewHLApp C)

Cara term mudah untuk membuat aplikasi tingkat tinggi baru adalah dengan memulai dengan salah satu sampel Azure Sphere tingkat tinggi:

1. Kloning repositori sampel jika Anda belum melakukannya. Salin salah satu folder aplikasi tingkat tinggi dan ganti namanya untuk proyek Anda.

2. Dalam file CMakeLists.txt, ubah nama proyek menjadi nama folder baru Anda. Contohnya:

   PROJECT(NewHLApp C)

Struktur file dasar aplikasi tingkat tinggi

Tidak peduli bagaimana Anda membuat aplikasi, semua aplikasi Azure Sphere berbagi file inti berikut:

• Kode sumber aplikasi dalam satu atau beberapa file. Saat ini, hanya kode sumber bahasa C yang didukung.
• File build CMake. CMakeLists.txt diperlukan. CMake, bersama dengan utilitas build ninja ringan, digunakan untuk mengontrol proses build aplikasi Azure Sphere.
• File manifes aplikasi yang menjelaskan kemampuan yang tersedia untuk aplikasi.

Aplikasi tingkat tinggi biasanya akan memiliki setidaknya tiga file lainnya:

• File applibs-versions.h untuk menentukan tingkat versi berbagai API Azure Sphere
• Dua file definisi perangkat keras (versi yang dapat diedit dalam format JSON dan bahasa C menyertakan file yang dihasilkan darinya) yang menyediakan cara mudah untuk merujuk ke komponen perangkat keras dalam kode Anda. Dengan serangkaian file definisi perangkat keras yang konsisten, Anda dapat menulis kode sumber independen perangkat keras dan kemudian membangun gambar aplikasi untuk perangkat keras tertentu hanya dengan menargetkan ulang file definisi perangkat keras yang sesuai dalam file CMakeLists.txt Anda.

Tulis kode Anda

1. Tulis kode aplikasi Anda menggunakan sampel aplikasi tingkat tinggi Azure Sphere sebagai panduan. Topik berikut menjelaskan skenario implementasi tertentu:
   • Menggunakan periferal dalam aplikasi tingkat tinggi
   • Menyambungkan ke layanan web
   • Menggunakan wolfSSL untuk koneksi TLS
   • Mengelola sertifikat
   • Memahami penggunaan memori
   • Menuangkan pembaruan perangkat
   • Mengelola waktu dan menggunakan jam real-time
   • Menggunakan penyimpanan perangkat
   • Berkomunikasi dengan aplikasi berkemampu real time
   • Mengelola status Power Down
   • Mengatur profil daya
   • Melakukan penemuan layanan
2. Dalam file CMakeLists.txt:
   • Menentukan revisi alat Azure Sphere SDK
   • Tentukan set API target
   • Tentukan perangkat keras target
3. Dalam file app_manifest.json:
   • Atur Name menggunakan nama proyek Anda.
   • Tambahkan kemampuan khusus aplikasi apa pun yang diperlukan kode Anda, seperti sumber daya perangkat keras atau koneksi. Jika aplikasi tingkat tinggi berkomunikasi dengan RTApp, tambahkan ID komponen aplikasi tingkat tinggi ke AllowedApplicationConnections kemampuan.

Jika Anda ingin menyebarkan aplikasi tingkat tinggi bersama aplikasi mitra berkemampuan real time, tambahkan ID komponen mitra ke bidang partnerComponents dari bagian konfigurasi file launch.vs.json (Visual Studio) atau .vscode/launch.json (Visual Studio Code):

"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

Lihat juga

• Bangun aplikasi tingkat tinggi.

• Debug aplikasi tingkat tinggi.