Mulai Cepat: Menginstal SDK Azure Sphere untuk Linux

Artikel
03/26/2024

Anda dapat menginstal Azure Sphere SDK di komputer yang menjalankan sistem operasi Linux untuk mengembangkan, menyebarkan, dan men-debug aplikasi Azure Sphere.

Prasyarat

Penginstalan SDK Azure Sphere memerlukan prasyarat berikut:

Kit pengembangan Azure Sphere.
Komputer dengan prosesor berbasis x86-64 yang menjalankan Ubuntu 24.04 64-bit (pra-rilis), Ubuntu 22.04 LTS, atau Ubuntu 20.04 LTS. Hanya prosesor x86-64 yang kompatibel dengan Intel yang didukung; arsitektur lain seperti ARM (termasuk Raspberry Pi), Itanium, atau SPARC tidak didukung. Arsitektur x86-64 juga dikenal sebagai x64, x86_64, AMD64, dan Intel 64.
Izin Linux sudo .
Koneksi internet atau cara mentransfer file dari komputer yang memiliki koneksi internet ke komputer Anda. Untuk informasi selengkapnya, lihat Menginstal SDK tanpa koneksi internet.

Menambahkan paket Linux yang diperlukan

Sebelum menjalankan skrip penginstalan SDK, Anda perlu menambahkan paket Linux yang diperlukan ke komputer jika belum diinstal. Masukkan baris berikut di terminal Linux. Anda dapat menghilangkan paket yang sudah terinstal.

sudo apt-get update
sudo apt-get install -y net-tools curl

Menginstal SDK Azure Sphere

Ikuti langkah-langkah ini:

Unduh skrip penginstalan.
Navigasikan ke folder tempat Anda mengunduh file yang dipadatkan.
Ekstrak konten file yang dipadatkan. Misalnya, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. File .tar.gz berisi file install_azure_sphere_sdk.sh.
Jalankan skrip penginstalan menggunakan sudo sebagai berikut:
```
sudo ./install_azure_sphere_sdk.sh
```
Jika Anda melihat kesalahan command not found saat menjalankan skrip, aktifkan eksekusi skrip penginstalan dengan perintah ini:
```
chmod +x install_azure_sphere_sdk.sh
```

Selama penginstalan, skrip menampilkan pesan konfirmasi. Pesan konfirmasi bisa dilewati dengan memanggil skrip dengan -y bendera:

sudo ./install_azure_sphere_sdk.sh -y

-y Tanpa bendera, skrip akan mengharapkan respons terhadap perintah berikut:

The SDK tarball signature is valid. The fingerprint of the key used is:

Primary key fingerprint: <hexadecimal>

Please check that this fingerprint matches the Microsoft GPG public key fingerprint shown on https://aka.ms/AzureSphereSDKVerification/Linux before proceeding. Do not proceed if these values do not match.
Proceed with installation? (Y/N)

Navigasikan ke situs sidik jari kunci publik Microsoft dan verifikasi bahwa nilai sidik jari heksadesimal yang ditampilkan selama penginstalan cocok dengan Sidik Jari Kunci Publik Microsoft yang diperlihatkan di halaman. Jangan lanjutkan jika dua sidik jari tidak cocok.

Installing CLI.
This SDK contains two versions of the Azure Sphere CLI: the new Azure Sphere CLI (recommended) and Azure Sphere classic CLI (retiring). See https://aka.ms/AzureSphereCLIVersions for more information on the versions.

You can choose which version is available through the command 'azsphere'.

Note that the Azure Sphere classic CLI will always be available to use with 'azsphere_v1' and the new Azure Sphere CLI will always be available to use with 'azsphere_v2'.
Use the recommended (new) CLI for 'azsphere'? (Y/N)

Pilih Y untuk mengatur Azure Sphere CLI sebagai CLI default Atau N untuk mengatur Azure Sphere klasik CLI sebagai CLI default Anda.

Some device operations require root permissions, or permissions granted by a udev rule. Set up the default udev rule and group (azsphere), and add the current user to it? (Y/N)

Pilih Y untuk menyiapkan grup azsphere dan membuat aturan udev.

Setelah penginstalan selesai, Anda harus masuk lagi ke aplikasi desktop atau login shell untuk menginisialisasi CLI Azure Sphere (Warisan).

Setelah instalasi, perintah azsphere berada di PATH dan aturan udev baru untuk perangkat Anda berada di /etc/udev/rules.d/.

Skrip menginstal SDK ke /opt/azurespheresdk dan toolchains ke /opt/azurespheresdk/Sysroots/sysroot-version/tools, di mana versi sysroot mengidentifikasi sysroot yang mendukung pengembangan aplikasi oleh SDK.

Penginstal menginstal Versi CLI Azure Sphere (Warisan) dari CLI. Anda tidak perlu menghapus instalan versi saat ini karena penginstalan akan memperbarui versi yang sudah ada. Azure Sphere (Legacy) CLI diinstal di /opt/azurespheresdk/Tools_v2 dan Azure Sphere (Legacy) klasik CLI diinstal di /opt/azurespheresdk/Tools.

Di Linux, Anda dapat menjalankan Azure Sphere (Legacy) CLI dari terminal menggunakan azsphere_v2 dan azsphere jika CLI dipilih sebagai CLI default selama penginstalan.

Setelah menginstal CLI untuk pertama kalinya, periksa apakah CLI telah terinstal dan Anda mendapatkan versi yang benar dengan menjalankan versi peragaan azsphere.

Aturan Udev

SDK Azure Sphere menentukan udev aturan untuk informasi perangkat komputer Anda. SDK membuat grup baru yang dipanggil azsphere dan menambahkan pengguna yang saat ini masuk ke grup. Aturan ini udev memberikan kepemilikan perangkat USB yang cocok dengan deskripsi perangkat Azure Sphere. Setelah menginstal SDK dan melakukan boot ulang komputer, Anda tidak perlu menggunakannya sudo untuk pemulihan perangkat atau debugging ARM Cortex-M4.

Grup azsphere ditambahkan untuk memberikan izin menggunakan aturan.udev Jangan ubah grup secara manual.

Menginstal SDK tanpa koneksi internet

Jika Anda tidak memiliki koneksi internet di komputer tempat Anda menginstal SDK, Anda perlu mengunduh file ke komputer yang tersambung ke internet dan mentransfernya ke komputer instalasi.

Unduh file ini dan transfer ke komputer penginstalan:
- Azure Sphere SDK untuk Linux: pilih dari Ubuntu 24.04 (pra-rilis) atau Ubuntu 22.04 LTS atau Ubuntu 20.04 LTS.
  
  File yang diunduh adalah file tar terkompresi (file .tar.gz ) dengan nama yang dimulai Azure_Sphere_SDK_Bundle.
- Instal skrip: ini adalah file tar terkompresi (file .tar.gz ) dengan nama yang dimulai install_azure_sphere_sdk.
- Kunci publik GPG Microsoft: ini adalah file teks ASCII.
Pada komputer penginstalan, navigasikan ke folder tempat Anda mentransfer file.
Ekstrak konten file skrip penginstalan terkompresi. Misalnya, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. File .tar.gz berisi file install_azure_sphere_sdk.sh. Biarkan Azure Sphere SDK Bundle sebagai file tar terkompresi (file tar.gz ).
Jalankan skrip penginstalan menggunakan sudo. -i Sertakan parameter untuk menentukan jalur ke bundel SDK dan -k parameter untuk menentukan jalur ke kunci. Perintah Anda harus sama dengan ini:

sudo ./install_azure_sphere_sdk.sh -i [pathtopackage]/[sdkbundle] -k [pathtokey]/microsoft.asc

Jika Anda melihat kesalahan command not found saat menjalankan skrip, aktifkan eksekusi skrip penginstalan dengan perintah ini:
```
chmod +x install_azure_sphere_sdk.sh
```

Lanjutkan penginstalan seperti yang dijelaskan dalam Menginstal SDK Azure Sphere.

Menginstal ekstensi Azure Sphere untuk Azure CLI

Alat baris perintah untuk mengelola perangkat terlampir Azure Sphere dan penyebaran cloud didistribusikan sebagai ekstensi Azure CLI. Lakukan langkah-langkah berikut untuk menambahkan atau memperbarui ekstensi:

Instal Azure CLI jika Anda belum melakukannya.

Untuk menambahkan ekstensi Azure Sphere, jalankan perintah berikut:
```
az extension add --name azure-sphere
```
Untuk memperbarui ekstensi Azure Sphere, jalankan perintah berikut:
```
az extension udpate --name azure-sphere
```

Anda harus Masuk dengan Azure CLI untuk masuk ke langganan Azure yang ingin Anda gunakan untuk mengelola perangkat Azure Sphere.

Untuk informasi selengkapnya, lihat Mengunduh dan menjalankan ekstensi Azure Sphere.

Menyiapkan lingkungan pengembangan Anda

Anda dapat mengembangkan aplikasi Azure Sphere di Linux menggunakan Visual Studio Code atau antarmuka baris perintah (CLI). Apa pun yang Anda gunakan, Anda harus menginstal CMake dan Ninja di mesin pengembangan Anda, jika Anda belum memilikinya. Lihat instruksi untuk menambahkan Repositori APT Kitware ke instalasi Anda.

Instal CMake dan Ninja

Untuk menginstal CMake dan Ninja, lihat instruksi terlebih dahulu untuk menambahkan Repositori Kitware APT ke instalasi Anda, lalu gunakan perintah berikut:

sudo apt-get install cmake ninja-build

Catatan

Jangan instal cmake atau ninja menggunakan snap.

Menginstal ekstensi Azure Sphere untuk Visual Studio Code

Jika ingin menggunakan Visual Studio Code sebagai lingkungan pengembangan, Anda perlu menginstalnya dan Ekstensi Azure Sphere.

Gunakan tautan di Unduh Visual Studio Code untuk menginstal Visual Studio Code, jika Anda belum melakukannya.
Untuk menginstal ekstensi Azure Sphere, cari "Azure Sphere" di Extension Marketplace dari browser atau dalam Visual Studio Code. Anda akan melihat dua hasil, Azure Sphere dan Azure Sphere UI. Pilih Instal untuk salah satu; yang lain harus diinstal secara otomatis.
Setelah penginstalan, Anda akan melihat ekstensi Azure Sphere, C/C++, dan CMake Tools di panel Ekstensi ENABLED di Visual Studio Code IDE.

Ketika penginstalan selesai, halaman Bacame untuk ekstensi akan terbuka. Halaman Bacame menyediakan informasi yang berguna tentang konfigurasi dan persyaratan Visual Studio Code, dan diperbarui bersama dengan ekstensi. Anda dapat menampilkan halaman Bacame kapan saja dengan membuka panel Ekstensi dan memilih Azure Sphere.

Langkah berikutnya

Klaim perangkat Anda