Hızlı Başlangıç: Linux için Azure Sphere SDK'sını yükleme

  • Makale

Azure Sphere uygulamalarını geliştirmek, dağıtmak ve hatalarını ayıklamak için Linux işletim sistemini çalıştıran bir bilgisayara Azure Sphere SDK'sını yükleyebilirsiniz.

Önkoşullar

Azure Sphere SDK yüklemesi aşağıdaki önkoşulları gerektirir:

  • Azure Sphere geliştirme seti.
  • 64 bit Ubuntu 24.04 (yayın öncesi), Ubuntu 22.04 LTS veya Ubuntu 20.04 LTS çalıştıran x86-64 tabanlı işlemciye sahip bir bilgisayar. Yalnızca Intel uyumlu x86-64 işlemciler desteklenir; ARM (Raspberry Pi dahil), Itanium veya SPARC gibi diğer mimariler desteklenmez . x86-64 mimarisi x64, x86_64, AMD64 ve Intel 64 olarak da bilinir.
  • Linux sudo izni.
  • İnternet bağlantısı veya bilgisayarınıza İnternet bağlantısı olan bir bilgisayardan dosya aktarma yolu. Daha fazla bilgi için bkz. SDK'yı İnternet bağlantısı olmadan yükleme.

Gerekli Linux paketlerini ekleme

SDK yükleme betiğini çalıştırmadan önce, gerekli Linux paketlerini henüz yüklü değilse bilgisayarınıza eklemeniz gerekir. Linux terminaline aşağıdaki satırları girin. Zaten yüklü olan paketleri atlamış olabilirsiniz.

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

Azure Sphere SDK'sını yükleme

Şu adımları izleyin:

  1. Yükleme betiğini indirin.

  2. Sıkıştırılmış dosyayı indirdiğiniz klasöre gidin.

  3. Sıkıştırılmış dosyanın içeriğini ayıklayın. Örneğin, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. .tar.gz dosyası install_azure_sphere_sdk.sh dosyasını içerir.

  4. Yükleme betiğini aşağıdaki gibi komutunu kullanarak sudo çalıştırın:

    sudo ./install_azure_sphere_sdk.sh

    Betiği çalıştırırken hatayı command not found görürseniz şu komutla yükleme betiğinin yürütülmesini etkinleştirin:

    chmod +x install_azure_sphere_sdk.sh

  5. Yükleme sırasında betik onay iletilerini görüntüler. Onay iletileri, betiği bayrağıyla -y çağırarak atlanabilir:

    sudo ./install_azure_sphere_sdk.sh -y

    -y Bayrağı olmadan betik aşağıdaki istemlere yanıt bekler:

    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)

    Microsoft'un ortak anahtar parmak izi sitesine gidin ve yükleme sırasında görüntülenen onaltılık parmak izi değerinin sayfada gösterilen Microsoft Ortak Anahtar Parmak İzi ile eşleşip eşleşmediğini doğrulayın. İki parmak izi eşleşmiyorsa devam etmeyin.

    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)

    Azure Sphere CLI'yi varsayılan CLI'nız olarak veya N Azure Sphere klasik CLI'sini varsayılan CLI'nız olarak ayarlamak için seçinY.

    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)

    azsphere grubunu ayarlamak ve udev kuralını oluşturmak için öğesini seçinY.

  6. Yükleme tamamlandığında, Azure Sphere (Eski) CLI'yı başlatmak için masaüstü uygulamanızda veya oturum açma kabuğunuzda yeniden oturum açmanız gerekir.

Yüklemeden sonra azsphere komutu PATH üzerindedir ve cihazınız için yeni udev kuralları konumundadır /etc/udev/rules.d/.

Betik SDK'yı /opt/azurespheresdk'e ve araç zincirlerini /opt/azurespheresdk/Sysroots/sysroot-version/tools'a yükler. Burada sysroot-version , SDK'nın uygulama geliştirmeyi desteklediği bir sysroot tanımlar.

Yükleyici, CLI'nın Azure Sphere (Eski) CLI sürümlerini yükler. Yükleme mevcut sürümü güncelleştireceği için geçerli sürümü kaldırmanız gerekmez. Azure Sphere (Eski) CLI /opt/azurespheresdk/Tools_v2 ve Azure Sphere (Eski) klasik CLI ise /opt/azurespheresdk/Tools içinde yüklenir.

Linux'ta Azure Sphere (Eski) CLI'yi bir terminalden ve yükleme sırasında varsayılan CLI olarak seçilip seçilmediğini kullanarak azsphere_v2azsphere çalıştırabilirsiniz.

CLI'yi ilk kez yükledikten sonra azsphere show-version komutunu çalıştırarak yüklü olup olmadığını ve doğru sürümü edinip edinmediğini denetleyin.

Udev kuralları

Azure Sphere SDK'sı, bilgisayarınızın cihaz bilgilerine ilişkin kuralları belirtir udev . SDK adlı azsphere yeni bir grup oluşturur ve şu anda oturum açmış olan kullanıcıyı gruba ekler. Kural, udev Azure Sphere cihaz açıklamasıyla eşleşen USB cihazlarının sahipliğini verir. SDK'yı yükleyip bilgisayarınızı yeniden başlattıktan sonra, cihaz kurtarma veya ARM Cortex-M4 hata ayıklaması için kullanmanız sudo gerekmez.

Grup azsphere , kuralı kullanarak udev izinler vermek için eklenir. Grubu el ile değiştirmeyin.

SDK'yi İnternet bağlantısı olmadan yükleme

SDK'yı yüklediğiniz bilgisayarda İnternet bağlantınız yoksa, dosyaları İnternet'e bağlı bir bilgisayara indirmeniz ve yükleme bilgisayarına aktarmanız gerekir.

  1. Bu dosyaları indirin ve yükleme bilgisayarına aktarın:

  2. Yükleme bilgisayarında, dosyaları aktardığınız klasöre gidin.

  3. Sıkıştırılmış yükleme betiği dosyasının içeriğini ayıklayın. Örneğin, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. .tar.gz dosyası install_azure_sphere_sdk.sh dosyasını içerir. Azure Sphere SDK Paketi'ni sıkıştırılmış katran dosyası (tar.gz dosyası) olarak bırakın.

  4. kullanarak yükleme betiğini sudoçalıştırın. SDK paketinin -i yolunu belirtmek için parametresini ve anahtarın -k yolunu belirtmek için parametresini ekleyin. Komutunuz şuna benzer olmalıdır:

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

    Betiği çalıştırırken hatayı command not found görürseniz şu komutla yükleme betiğinin yürütülmesini etkinleştirin:

    chmod +x install_azure_sphere_sdk.sh

Azure Sphere SDK'sını yükleme bölümünde açıklandığı gibi yüklemeye devam edin.

Azure CLI için Azure Sphere uzantısını yükleme

Azure Sphere'a bağlı cihazları ve bulut dağıtımlarını yönetmeye yönelik komut satırı aracı bir Azure CLI uzantısı olarak dağıtılır. Uzantıyı eklemek veya güncelleştirmek için aşağıdaki adımları uygulayın:

  1. Henüz yapmadıysanız Azure CLI'yi yükleyin.

  • Azure Sphere uzantısını eklemek için aşağıdaki komutu çalıştırın:

    az extension add --name azure-sphere

  • Azure Sphere uzantısını güncelleştirmek için aşağıdaki komutu çalıştırın:

    az extension udpate --name azure-sphere

Azure Sphere cihazlarını yönetmek için kullanmak istediğiniz Azure aboneliğinde oturum açmak için Azure CLI ile oturum açmanız gerekir.

Daha fazla bilgi için bkz. Azure Sphere uzantısını indirme ve çalıştırma.

Geliştirme ortamınızı ayarlama

Visual Studio Code veya komut satırı arabirimini (CLI) kullanarak Linux üzerinde Azure Sphere uygulamaları geliştirebilirsiniz. Hangilerini kullanırsanız kullanın, henüz yoksa geliştirme makinenize CMake ve Ninja yüklemeniz gerekir. Kitware APT Deposunu yüklemenize ekleme yönergelerine bakın.

CMake ve Ninja yükleme

CMake ve Ninja'yı yüklemek için önce Kitware APT Deposunu yüklemenize ekleme yönergelerine bakın ve ardından aşağıdaki komutu kullanın:

sudo apt-get install cmake ninja-build

Not

Snap kullanarak cmake veya ninja yüklemeyin.

Visual Studio Code için Azure Sphere uzantısını yükleme

geliştirme ortamınız olarak Visual Studio Code kullanmak istiyorsanız, bunu ve Azure Sphere Uzantısı'nı yüklemeniz gerekir.

  1. Henüz yapmadıysanız Visual Studio Code yüklemek için İndirme Visual Studio Code'ndeki bağlantıları kullanın.

  2. Azure Sphere uzantısını yüklemek için Uzantı Marketi'nde bir tarayıcıdan veya Visual Studio Code içinde "Azure Sphere" araması yapın. Azure Sphere ve Azure Spherekullanıcı arabirimi olarak iki sonuç görmeniz gerekir. Her ikisinde de Yükle'yi seçin; diğerinin otomatik olarak yüklenmesi gerekir.

  3. Yüklemeden sonra, Visual Studio Code IDE'nin ENABLED Uzantıları bölmesinde Azure Sphere, C/C++ ve CMake Araçları uzantılarını görmeniz gerekir.

Yükleme tamamlandığında uzantının BeniOku sayfası açılır. BeniOku sayfası, Visual Studio Code yapılandırması ve gereksinimleri hakkında yararlı bilgiler sağlar ve uzantıyla birlikte güncelleştirilir. Uzantılar bölmesini açıp Azure Sphere'i seçerek benioku sayfasını istediğiniz zaman görüntüleyebilirsiniz.

Sonraki adımlar

Cihazınızı talep etme

Not

Snap kullanarak cmake veya ninja yüklemeyin.