Tworzenie aplikacji wysokiego poziomu
Najłatwiejszym sposobem na utworzenie nowej aplikacji wysokiego poziomu jest rozpoczęcie od pustego szablonu z rozszerzenia Visual Studio Code Azure Sphere i dostosowanie konfiguracji do projektu, wykonując następujące czynności:
Rozpocznij Visual Studio Code. Wybierz pozycję Wyświetl>paletę poleceń, a następnie wpisz Azure Sphere: Generate New Project (Wygeneruj nowy projekt).
Z menu Szablony wybierz pozycję HL Blank (Puste wartości HL).
Visual Studio Code następnie zostanie wyświetlone okno Eksplorator plików. Przejdź do folderu, w którym chcesz umieścić pustą aplikację i podaj nazwę projektu, na przykład NewHLApp. Visual Studio Code tworzy folder NewHLApp w wybranej lokalizacji i generuje pliki kompilacji dla pustej aplikacji. Powinny być widoczne wiadomości z usługi CMake.
Otwórz plik CMakeLists.txt i określ folder zawierający definicje używanego sprzętu. Domyślnie pusta aplikacja HL nie zawiera definicji sprzętu. Możesz znaleźć przykładowe definicje sprzętu w repozytorium Próbki azure Sphere lub utworzyć jedną z nich zgodnie z opisem w artykule Definicje sprzętu.
Poniżej przedstawiono sposób dodawania przykładowych definicji sprzętu dla zestawu deweloperów Seeed Azure Sphere MT3620:
azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")
Ten wiersz powinien zostać wstawiony przed rozpoczęciem
azsphere_target_add_image_package
ostatniego polecenia.
Możesz również utworzyć nową aplikację wysokiego poziomu na podstawie dowolnej z próbek platformy Azure Sphere wysokiego poziomu:
Sklonuj próbki ponownie , jeśli jeszcze tego nie zrobiono. Skopiuj jeden z folderów aplikacji wysokiego poziomu i zmień jego nazwę dla projektu.
W pliku CMakeLists.txt zmień nazwę projektu na nazwę nowego folderu. Na przykład:
PROJECT(NewHLApp C)
Najprostszym sposobem utworzenia nowej aplikacji wysokiego poziomu jest rozpoczęcie od pustego szablonu z rozszerzenia Visual Studio Azure Sphere i dostosowanie konfiguracji do projektu, wykonując następujące czynności:
Uruchom program Visual Studio i wybierz pozycję Utwórz nowy projekt.
Wpisz
Azure Sphere
tekst w polu wyszukiwania z etykietą Wyszukaj szablony. Wybierz pozycję Azure Sphere HLCore Blank z listy zwróconych, a następnie wybierz pozycję Dalej.Określ nazwę projektu (na przykład NewHLApp), lokalizację pliku projektu i nazwę rozwiązania (która może być taka sama jak nazwa projektu), a następnie wybierz pozycję Utwórz. Program Visual Studio utworzy folder NewHLpp w wybranej lokalizacji i wygeneruje pliki kompilacji dla pustej aplikacji. Powinny być widoczne wiadomości z usługi CMake.
Otwórz plik CMakeLists.txt i określ folder zawierający definicje używanego sprzętu. Domyślnie pusta aplikacja HL nie zawiera definicji sprzętu. Możesz znaleźć przykładowe definicje sprzętu w repozytorium Próbki azure Sphere lub utworzyć jedną z nich zgodnie z opisem w artykule Definicje sprzętu.
Poniżej przedstawiono sposób dodawania przykładowych definicji sprzętu dla zestawu deweloperów Seeed Azure Sphere MT3620:
azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")
Ten wiersz powinien zostać wstawiony przed rozpoczęciem
azsphere_target_add_image_package
ostatniego polecenia.
Możesz również utworzyć nową aplikację wysokiego poziomu na podstawie dowolnej z próbek platformy Azure Sphere wysokiego poziomu:
Sklonuj próbki ponownie , jeśli jeszcze tego nie zrobiono. Skopiuj jeden z folderów aplikacji wysokiego poziomu i zmień jego nazwę dla projektu.
W pliku CMakeLists.txt zmień nazwę projektu na nazwę nowego folderu. Na przykład:
PROJECT(NewHLApp C)
Najprostszym sposobem na utworzenie nowej aplikacji wysokiego poziomu jest rozpoczęcie od dowolnej z próbek usługi Azure Sphere wysokiego poziomu:
Sklonuj próbki ponownie , jeśli jeszcze tego nie zrobiono. Skopiuj jeden z folderów aplikacji wysokiego poziomu i zmień jego nazwę dla projektu.
W pliku CMakeLists.txt zmień nazwę projektu na nazwę nowego folderu. Na przykład:
PROJECT(NewHLApp C)
Podstawowa struktura plików aplikacji wysokiego poziomu
Niezależnie od sposobu tworzenia aplikacji wszystkie aplikacje Azure Sphere udostępniają następujące pliki podstawowe:
- Kod źródłowy aplikacji w jednym lub kilku plikach. Obecnie jest obsługiwany tylko kod źródłowy języka C.
- Pliki kompilacji CMake. CMakeLists.txt jest wymagane. CMake, wraz z narzędziem ninja lightweight build, jest używany do sterowania procesem tworzenia aplikacji Azure Sphere.
- Plik manifestu aplikacji z opisem możliwości dostępnych dla aplikacji.
Aplikacje wysokiego poziomu zwykle mają co najmniej trzy inne pliki:
- Plik applibs-versions.h określający poziomy wersji różnych interfejsów API Azure Sphere
- Dwa pliki definicji sprzętu (wersja edytowalna w formacie JSON i język C obejmują wygenerowany z niego plik), które zapewniają wygodny sposób odwoływania się do składników sprzętu w kodzie. Dzięki spójnemu zestawowi plików definicji sprzętu możesz pisać kod źródłowy niezależny od sprzętu, a następnie tworzyć obrazy aplikacji dla określonego sprzętu, po prostu ponownie kierując odpowiedni plik definicji sprzętu w pliku CMakeLists.txt.
Napisz swój kod
- Napisz kod aplikacji, używając przykładów aplikacji wysokiego poziomu Azure Sphere jako przewodników. W poniższych tematach opisano konkretne scenariusze implementacji:
- Korzystanie z urządzeń peryferyjnych w aplikacji wysokiego poziomu
- Nawiązywanie połączenia z usługami sieci Web
- Używanie wolfSSL do połączeń TLS
- Zarządzanie certyfikatami
- Opis użycia pamięci
- Odraczania aktualizacji urządzenia
- Zarządzanie czasem i korzystanie z zegara w czasie rzeczywistym
- Korzystanie z pamięci urządzenia
- Komunikowanie się za pomocą aplikacji obsługowej w czasie rzeczywistym
- Zarządzanie stanem zasilania
- Ustawianie profilów zasilania
- Przeprowadzanie odnajdowania usługi
- W plikuCMakeLists.txt:
- Określanie poprawki narzędzia Azure Sphere SDK
- Określanie docelowego zestawu interfejsu API
- Określanie sprzętu docelowego
- W pliku app_manifest.json:
- Ustaw
Name
nazwę projektu. - Dodaj wszelkie funkcje specyficzne dla aplikacji wymagane przez kod, takie jak zasoby sprzętowe lub połączenia. Jeśli aplikacja wysokiego poziomu komunikuje się z RTApp, dodaj identyfikator składnika aplikacji wysokiego poziomu do
AllowedApplicationConnections
funkcji.
- Ustaw
Jeśli chcesz wdrożyć aplikację wysokiego poziomu wraz z aplikacją partnera z obsługą czasu rzeczywistego, dodaj identyfikator składnika partnera do pola partnerComponents sekcji konfiguracji pliku launch.vs.json (Visual Studio) lub vscode/launch.json (Visual Studio Code):
"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]