Üst düzey uygulama oluşturma
Önemli
Bu, Azure Sphere (Eski) belgeleridir. Azure Sphere (Eski) 27 Eylül 2027'de kullanımdan kaldırılıyor ve kullanıcıların bu zamana kadar Azure Sphere'e (Tümleşik) geçmeleri gerekiyor. Azure Sphere (Tümleşik) belgelerini görüntülemek için İçindekiler tablosu üzerinde bulunan Sürüm seçiciyi kullanın.
Yeni bir üst düzey uygulama oluşturmanın en kolay yolu, Visual Studio Code Azure Sphere uzantısından Boş şablonla başlamak ve aşağıdaki adımları izleyerek yapılandırmayı projenize ayarlamaktır:
Visual Studio Code’u başlatın. Komut paleti Görüntüle'yi>seçin ve ardından Azure Sphere: Yeni Proje Oluştur yazın.
Şablonlar menüsünden HL Boş'u seçin.
Visual Studio Code daha sonra bir Dosya Gezgini penceresi görüntüler. Boş uygulamayı yerleştirmek istediğiniz klasöre gidin ve projeniz için yeni bir ad (örneğin, NewHLApp) belirtin. Visual Studio Code, seçtiğiniz konumda NewHLApp klasörünü oluşturur ve boş uygulama için derleme dosyalarını oluşturur. CMake’den gelen iletileri görüyor olmalısınız.
CMakeLists.txt dosyasını açın ve kullandığınız donanımın tanımlarını içeren klasörü belirtin. Varsayılan olarak, HL Boş uygulaması donanım tanımı içermez. Örnek donanım tanımlarını Azure Sphere Örnekleri deposunda bulabilir veya Donanım tanımları bölümünde açıklandığı gibi oluşturabilirsiniz.
Aşağıda, Seeed Azure Sphere MT3620 Geliştirme Seti için örnek donanım tanımlarının nasıl ekleneceği gösterilmektedir:
azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")
Bu satır, son komut başlamadan
azsphere_target_add_image_package
önce eklenmelidir.
Ayrıca, üst düzey Azure Sphere örneklerinden herhangi birinden yeni bir üst düzey uygulama oluşturabilirsiniz:
Yeni bir üst düzey uygulama oluşturmanın en kolay yolu, Visual Studio Azure Sphere uzantısından Boş şablonla başlamak ve aşağıdaki adımları izleyerek yapılandırmayı projenize ayarlamaktır:
Visual Studio'yu başlatın ve Yeni proje oluştur'u seçin.
Şablon ara etiketli arama kutusuna yazın
Azure Sphere
. Döndürülen listeden Azure Sphere HLCore Blank'ı ve ardından İleri'yi seçin.Bir proje adı (örneğin, NewHLApp), proje dosyası konumu ve çözüm adı (proje adıyla aynı olabilir) belirtin ve oluştur'u seçin. Visual Studio, seçtiğiniz konumda NewHLpp klasörünü oluşturur ve boş uygulama için derleme dosyalarını oluşturur. CMake’den gelen iletileri görüyor olmalısınız.
CMakeLists.txt dosyasını açın ve kullandığınız donanımın tanımlarını içeren klasörü belirtin. Varsayılan olarak, HL Boş uygulaması donanım tanımı içermez. Örnek donanım tanımlarını Azure Sphere Örnekleri deposunda bulabilir veya Donanım tanımları bölümünde açıklandığı gibi oluşturabilirsiniz.
Aşağıda, Seeed Azure Sphere MT3620 Geliştirme Seti için örnek donanım tanımlarının nasıl ekleneceği gösterilmektedir:
azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")
Bu satır, son komut başlamadan
azsphere_target_add_image_package
önce eklenmelidir.
Ayrıca, üst düzey Azure Sphere örneklerinden herhangi birinden yeni bir üst düzey uygulama oluşturabilirsiniz:
Yeni bir üst düzey uygulama oluşturmanın en kolay yolu, üst düzey Azure Sphere örneklerinden herhangi biriyle başlamaktır:
Üst düzey bir uygulamanın temel dosya yapısı
Uygulamanızı nasıl oluşturursanız oluşturun, tüm Azure Sphere uygulamaları aşağıdaki temel dosyaları paylaşır:
- Bir veya daha fazla dosyada uygulama kaynak kodu. Şu anda yalnızca C dili kaynak kodu desteklenmektedir.
- CMake derleme dosyaları. CMakeLists.txt gereklidir. CMake, ninja basit derleme yardımcı programıyla birlikte Azure Sphere uygulama derleme işlemini denetlemek için kullanılır.
- Uygulamanın kullanabileceği özellikleri açıklayan bir uygulama bildirimi dosyası.
Üst düzey uygulamalarda genellikle en az üç dosya daha olur:
- Çeşitli Azure Sphere API'lerinin sürüm düzeylerini belirten bir applibs-versions.h dosyası
- Kodunuzdaki donanım bileşenlerine başvurmak için kullanışlı bir yol sağlayan iki donanım tanım dosyası (JSON biçiminde düzenlenebilir bir sürüm ve ondan oluşturulan bir C dili ekleme dosyası). Tutarlı bir donanım tanım dosyaları kümesiyle, donanımdan bağımsız kaynak kodu yazabilir ve ardından CMakeLists.txt dosyanızdaki uygun donanım tanımı dosyasını yeniden hedefleyerek belirli donanımlar için uygulama görüntüleri oluşturabilirsiniz.
Kodunuzu yazma
- Azure Sphere üst düzey uygulama örneklerini kılavuz olarak kullanarak uygulama kodunuzu yazın. Aşağıdaki konular belirli uygulama senaryolarını açıklar:
- Üst düzey bir uygulamada çevre birimleri kullanma
- Web hizmetlerine bağlanma
- TLS bağlantıları için wolfSSL kullanma
- Sertifikaları yönetme
- Bellek kullanımını anlama
- Cihaz güncelleştirmelerini erteleme
- Zamanı yönetme ve gerçek zamanlı saati kullanma
- Cihaz depolamayı kullanma
- Gerçek zamanlı uyumlu bir uygulamayla iletişim kurma
- Güç Azaltma durumunu yönetme
- Güç profillerini ayarlama
- Hizmet bulma gerçekleştirme
- CMakeLists.txt dosyasında:
- Azure Sphere SDK araçları düzeltmesi belirtme
- Hedef API kümesini belirtme
- Hedef donanımı belirtme
- app_manifest.json dosyasında:
Name
öğesini proje adınıza ayarlayın.- Donanım kaynakları veya bağlantılar gibi kodunuzun gerektirdiği uygulamaya özgü özellikleri ekleyin. Üst düzey uygulama bir RTApp ile iletişim kurarsa, üst düzey uygulamanın
AllowedApplicationConnections
bileşen kimliğini özelliğe ekleyin.
Üst düzey uygulamanızı gerçek zamanlı bir iş ortağı uygulamasıyla birlikte dağıtmak istiyorsanız, iş ortağının bileşen kimliğini launch.vs.json (Visual Studio) veya .vscode/launch.json (Visual Studio Code) dosyasının yapılandırmalar bölümünün partnerComponents alanına ekleyin:
"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]