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:

1. Rozpocznij Visual Studio Code. Wybierz pozycję Wyświetl>paletę poleceń, a następnie wpisz Azure Sphere: Generate New Project (Wygeneruj nowy projekt).

   

2. Z menu Szablony wybierz pozycję HL Blank (Puste wartości HL).

   

3. 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.

4. 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_packageostatniego polecenia.

Możesz również utworzyć nową aplikację wysokiego poziomu na podstawie dowolnej z próbek platformy Azure Sphere wysokiego poziomu:

1. Sklonuj próbki ponownie , jeśli jeszcze tego nie zrobiono. Skopiuj jeden z folderów aplikacji wysokiego poziomu i zmień jego nazwę dla projektu.

2. 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:

1. Uruchom program Visual Studio i wybierz pozycję Utwórz nowy projekt.

2. 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.

3. 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.

4. 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_packageostatniego polecenia.

Możesz również utworzyć nową aplikację wysokiego poziomu na podstawie dowolnej z próbek platformy Azure Sphere wysokiego poziomu:

1. Sklonuj próbki ponownie , jeśli jeszcze tego nie zrobiono. Skopiuj jeden z folderów aplikacji wysokiego poziomu i zmień jego nazwę dla projektu.

2. 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:

1. Sklonuj próbki ponownie , jeśli jeszcze tego nie zrobiono. Skopiuj jeden z folderów aplikacji wysokiego poziomu i zmień jego nazwę dla projektu.

2. 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

1. 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
2. W plikuCMakeLists.txt:
   • Określanie poprawki narzędzia Azure Sphere SDK
   • Określanie docelowego zestawu interfejsu API
   • Określanie sprzętu docelowego
3. 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.

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" ]

Zobacz też

• Stwórz aplikację wysokiego poziomu.
• Debugowanie aplikacji wysokiego poziomu.