Membuat aplikasi tingkat tinggi

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

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

   

2. Pilih HL Kosong dari menu Templat.

   

3. Visual Studio Code lalu menampilkan jendela File Explorer. Navigasikan 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 dipilih 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 Kosong tidak berisi definisi perangkat keras. Anda dapat menemukan definisi perangkat keras sampel di penyimpanan Sampel Azure Sphere atau membuatnya seperti yang dijelaskan dalam Definisi perangkat keras.

   Berikut ini memperlihatkan cara menambahkan definisi perangkat keras sampel untuk Kit Pengembangan MT3620 Azure Sphere yang Terlihat:

   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 sampel repo 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. Misalnya:

   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, lalu pilih Buat proyek baru.

2. Ketik Azure Sphere dalam 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 dipilih 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 Kosong tidak berisi definisi perangkat keras. Anda dapat menemukan definisi perangkat keras sampel di penyimpanan Sampel Azure Sphere atau membuatnya seperti yang dijelaskan dalam Definisi perangkat keras.

   Berikut ini memperlihatkan cara menambahkan definisi perangkat keras sampel untuk Kit Pengembangan MT3620 Azure Sphere yang Terlihat:

   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 sampel repo 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. Misalnya:

   PROJECT(NewHLApp C)

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

1. Kloning sampel repo 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. Misalnya:

   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 kapabilitas 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 yang mudah untuk merujuk ke komponen perangkat keras dalam kode Anda. Dengan kumpulan file definisi perangkat keras yang konsisten, Anda dapat menulis kode sumber independen perangkat keras lalu membuat gambar aplikasi untuk perangkat keras tertentu cukup dengan menargetkan ulang file definisi perangkat keras yang sesuai dalam file CMakeLists.txt Anda.

Menulis kode Anda

1. Tulis kode aplikasi Anda menggunakan sampel aplikasi tingkat tinggi Azure Sphere sebagai panduan. Topik berikut ini menjelaskan skenario implementasi tertentu:
   • Menggunakan periferal dalam aplikasi tingkat tinggi
   • Menyambungkan ke layanan web
   • Menggunakan wolfSSL untuk koneksi TLS
   • Mengelola sertifikat
   • Memahami penggunaan memori
   • Menangguhkan pembaruan perangkat
   • Mengelola waktu dan menggunakan jam real-time
   • Menggunakan penyimpanan perangkat
   • Berkomunikasi dengan aplikasi yang berkemampuan real-time
   • Kelola status Power Down
   • Mengatur profil daya
   • Melakukan penemuan layanan
2. Dalam fileCMakeLists.txt:
   • Menentukan revisi alat SDK Azure Sphere
   • Tentukan kumpulan API target
   • Tentukan perangkat keras target
3. Dalam file app_manifest.json:
   • Atur Name ke nama proyek Anda.
   • Tambahkan kapabilitas 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 kapabilitas.AllowedApplicationConnections

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

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

Lihat juga

• Buat aplikasi tingkat tinggi.
• Debug aplikasi tingkat tinggi.