Uzak konakta Secure Shell (SSH) ile Visual Studio Code kullanma

Visual Studio Code, Secure Shell (SSH) aracılığıyla uzak bir konakta kod derlemek ve hata ayıklamak için Azure Sphere SDK'sı ile kullanılabilir. İki senaryo desteklenir:

• Uzak makinedeki kod ve yerel makinedeki cihaz.

• Uzak makinede hem kod hem de cihaz.

Üçüncü bir senaryo (yerel makinedeki kod ve uzak makinedeki cihaz) desteklenmez.

Yerel makineyi ayarlama

1. Visual Studio Code indirip yükleyin.

2. Windows veya Linuxiçin Azure Sphere SDK'sını yükleyin.

3. Visual Studio Code uzantısı panelinde Azure Sphere'ı arayarak ve Yükle'ye tıklayarak Azure Sphere uzantısını yükleyin.

   Ipucu

   İki Azure Sphere uzantı vardır ve bu uzantılardan biri yüklenirken her ikisi de yüklenir: KULLANıCı arabirimi bileşeni için Azure Sphere kullanıcı arabirimi ve çalışma alanı bileşeni için Azure Sphere .

4. Visual Studio Code uzantısı panelinde Remote-SSH'yi arayarak ve Yükle düğmesine tıklayarak Remote-SSH uzantısını yükleyin.

Uzak makineyi ayarlama

1. Uzak makinenizi anahtar tabanlı kimlik doğrulaması için ayarlamanızı kesinlikle öneririz.
2. Windows veya Linuxiçin Azure Sphere SDK'sını yükleyin.

Uzak makinedeki kod ve yerel makinedeki cihaz

1. Cihazı yerel makineye bağlayın ve yerel makine Linux çalıştırıyorsa azsphere_connect.sh betiğini çalıştırın.
2. Uzak makinede henüz bir proje yoksa, örnek deposunu kopyalayabilir veya Microsoft Samples Browser'dan tek bir proje edinebilirsiniz.
3. Visual Studio Code yerel olarak açın.
4. Yalnızca ilk kez:Komut Paletini>Görüntüle>Remote-SSH'den Visual Studio Code açın: Yeni SSH konağı ekleyin ve istendiği gibi SSH ana bilgisayar bilgilerini girin. (Varsayılan olarak, config adlı bir dosya giriş dizininizdeki .ssh dizinine yazılır. Bu, yerel makineniz Windows ise bazen izin sorunlarına neden olur. Dosyayı başka bir dizine taşımak ve Dosya>Tercihleri>Ayarları>Uzantıları>Uzak - SSH: Yapılandırma Dosyası'nda mutlak yolu belirtmek isteyebilirsiniz.)

Uzak makineye bağlanma

1. Uzak makineye bağlanmak için Visual Studio Code komutunu KomutPaletini>Görüntüle>Remote-SSH: Konağa bağlan (Shift+Ctrl+P ) komutunu yürütebilirsiniz.

2. Visual Studio Code uzantısı panelinde Azure Sphere'ı arayarak ve SSH'de yükle: [uzak ad] düğmesine tıklayarak Azure Sphere uzantılarını uzak makineye yükleyin. Visual Studio Code yeniden başlatmanız ve yükledikten sonra uzak makineye yeniden bağlanmanız gerekebilir.

   Ipucu

   Uzantının uzak makineye doğru yüklenip yüklenmediğini denetlemek için uzantı panelindeki arama kutusunu temizleyin ve uzantıların SSH: [uzak ad] - YÜKLÜ görünümünde göründüğünden emin olunAzure Sphere.

3. DosyaAç Klasörü veya Dosya>Açma çalışma alanını kullanarak proje klasörünü veya> çalışma alanını açın.

Derleme, yerel cihaza dağıtma ve hata ayıklama

1. Projeyi derlemek ve hatalarını ayıklamak için F5 tuşuna basın. Proje daha önce oluşturulmamışsa veya dosyalar değişmişse ve yeniden derleme gerekiyorsa, Visual Studio Code hata ayıklama başlamadan önce projeyi oluşturur.

2. Visual Studio Code uygulamayı derlemesi, bir görüntü paketi oluşturması, panoya dağıtması ve hata ayıklama modunda başlatması için birkaç saniye bekleyin. Bu arada Çıkış bölmesinde durum güncelleştirmelerini görürsünüz.

   İlk olarak, CMake uygulamanın derlenmesi gerekip gerekmediğini belirler. Bu durumda odak, CMake/Build çıkışını görüntüleyen çıkış penceresine geçer.

   Ardından, görüntü paketi cihaza dağıtıldığında Çıkış bölmesi sonucu gösterir. Son olarak, Hata Ayıklama Konsolu odağı alır ve hata ayıklayıcısı çıkışını gösterir.

Kesme noktaları ayarlamak, duraklatmak, üzerine gitmek, uygulamaya girmek, uygulamayı yeniden başlatmak veya durdurmak için Visual Studio Code hata ayıklayıcısını kullanın.

Uzak makinede kod ve cihaz

1. Cihazı USB aracılığıyla uzak makineye bağlayın ve uzak makine Linux çalıştırıyorsa azsphere_connect.sh betiğini çalıştırın.
2. Uzak makinede henüz bir proje yoksa, örnek deposunu kopyalayabilir veya Microsoft Samples Browser'dan tek bir proje edinebilirsiniz.
3. Visual Studio Code yerel olarak açın.
4. Yalnızca ilk kez:Komut Paletini>Görüntüle>Remote-SSH'den Visual Studio Code açın: Yeni SSH konağı ekleyin ve istendiği gibi SSH ana bilgisayar bilgilerini girin. (Varsayılan olarak, config adlı bir dosya giriş dizininizdeki .ssh dizinine yazılır. Bu, yerel makineniz Windows ise bazen izin sorunlarına neden olur. Dosyayı başka bir dizine taşımak ve Dosya>Tercihleri>Ayarları>Uzantıları>Uzak - SSH: Yapılandırma Dosyası'nda mutlak yolu belirtmek isteyebilirsiniz.)

Uzak makineye bağlanma ve uzak ayarları yapılandırma

1. VS Code komutunu View>Command Palette>Remote-SSH: Connect to host (Shift+Ctrl+P ) yürüterek uzak makineye bağlanın.

2. VS Code komutunu KomutPaleti> Tercihlerini Görüntüle> komutunu yürüterek uzak ayarları ekleyin: Uzak Ayarlar'ı açın ve JSON nesnesine aşağıdaki alanı ekleyin (boş bir dosyaysa, bunu içine {}sarmalamanız gerekir):

       "remote.extensionKind": {
           "ms-vscode.azure-sphere-tools-ui": [
               "workspace"
           ]
       }
   

   Bunun yerine, projelerinizin ve ekibinizin kurulumuna bağlı olarak bu ayarı kullanıcı/çalışma alanı ayarlarına ekleyebilirsiniz.

3. Visual Studio Code uzantısı panelinde Azure Sphere'ı arayarak ve SSH'de yükle: [uzak ad] düğmesine tıklayarak Azure Sphere uzantılarını uzak makineye yükleyin. Visual Studio Code yeniden başlatmanız ve yükledikten sonra uzak makineye yeniden bağlanmanız gerekebilir.

   Ipucu

   Uzantının uzak makineye doğru yüklenip yüklenmediğini denetlemek için uzantı panelindeki arama kutusunu temizleyin ve uzantıların SSH: [uzak ad] - YÜKLÜ görünümünde göründüğünden emin olunAzure Sphere.

4. DosyaAç Klasörü veya Dosya> Açma çalışma alanını kullanarak proje klasörünü veya>çalışma alanını açın'.

Derleme, uzak cihaza dağıtma ve hata ayıklama

1. Projeyi derlemek ve hatalarını ayıklamak için F5 tuşuna basın. Proje daha önce oluşturulmamışsa veya dosyalar değişmişse ve yeniden derleme gerekiyorsa, Visual Studio Code hata ayıklama başlamadan önce projeyi oluşturur.

2. Visual Studio Code uygulamayı derlemesi, bir görüntü paketi oluşturması, panoya dağıtması ve hata ayıklama modunda başlatması için birkaç saniye bekleyin. Bu arada Çıkış bölmesinde durum güncelleştirmelerini görürsünüz.

   İlk olarak, CMake uygulamanın derlenmesi gerekip gerekmediğini belirler. Bu durumda odak, CMake/Build çıkışını görüntüleyen çıkış penceresine geçer.

   Ardından, görüntü paketi cihaza dağıtıldığında Çıkış bölmesi sonucu gösterir. Son olarak, Hata Ayıklama Konsolu odağı alır ve hata ayıklayıcısı çıkışını gösterir.

Kesme noktaları ayarlamak, duraklatmak, üzerine gitmek, uygulamaya girmek, uygulamayı yeniden başlatmak veya durdurmak için Visual Studio Code hata ayıklayıcısını kullanın.

Bağlantıyı kapatma

Uzaktan hata ayıklama oturumlarını sonlandırmak için Dosya>Uzak Bağlantıyı Kapat'ı seçin.