구성 요소 ID란?
Important
Azure Sphere(레거시) 설명서입니다. Azure Sphere(레거시)는 2027년 9월 27일에 사용 중지되며 사용자는 이 시간까지 Azure Sphere(통합)로 마이그레이션해야 합니다. TOC 위에 있는 버전 선택기를 사용하여 Azure Sphere(통합) 설명서를 볼 수 있습니다.
모든 Azure Sphere 애플리케이션에는 고유 구성 요소 ID 가 있어야 쉽게 식별할 수 있습니다. 구성 요소 ID는 16진수 집합을 포함하는 문자열인 GUID(Globally Unique Identifier)라고도 하는 UUID(범용 고유 식별자)입니다. 예를 들어 02ce3860-3126-42af-8ac7-c2a661134129입니다. 각 애플리케이션에는 가능한 충돌을 방지하기 위해 다른 구성 요소 ID가 있습니다.
구성 요소 ID 생성
Visual Studio 또는 Visual Studio Code에서 CMake 프로젝트를 처음 열면 CMakeLists 생성이 자동으로 실행되고 app_manifest.json 파일에서 애플리케이션의 구성 요소 ID를 설정합니다. 구성 요소 ID 없이 애플리케이션을 실행하면 빌드가 실패합니다. 필요한 경우 GUID/UUID를 수동으로 생성하고 애플리케이션 매니페스트 설정을 업데이트할 수 있습니다.
GUID 또는 UUID를 생성하려면 다음을 수행합니다.
- 도구 메뉴에서 GUID 만들기를 선택합니다.
- GUID 생성기 프로그램에서 레지스트리 형식 옵션 단추를 선택하고 복사 단추를 선택한 후 종료 단추를 선택합니다.
생성된 GUID/UUID를 ComponentId
애플리케이션의 app_manifest.json 파일 필드에 붙여넣습니다. 예: "ComponentId": "a5e23798-9bef-4bb0-9ae9-45643e788cb7"
구성 요소 ID 찾기
애플리케이션을 식별하려면 애플리케이션의 구성 요소 ID가 필요합니다. 다음과 같은 방법으로 애플리케이션의 구성 요소 ID를 찾을 수 있습니다.
- 애플리케이션의 app_manifest.json 파일 필드에서 구성 요소 ID
ComponentId
를 확인합니다. - azsphere device app show-status 명령을 사용하여 연결된 디바이스에서 애플리케이션의 상태 및 구성 요소 ID를 나열합니다.
- azsphere device image list-installed 명령을 사용하여 연결된 디바이스에 현재 이미지를 나열합니다. 필요한 애플리케이션의 구성 요소 ID를 확인합니다.