コンポーネント ID とは
重要
これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に 再提供されておりユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の上にある Version セレクターを使用して、Azure Sphere (統合) のドキュメントを表示します。
簡単に識別できるように、すべての Azure Sphere アプリケーションに一意の コンポーネント ID が必要です。 コンポーネント ID は、グローバル一意識別子 (GUID) とも呼ばれる汎用一意識別子 (UUID) であり、16 進数のセットを含む文字列です。 たとえば、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 ジェネレーター] プログラム内で、 [4. レジストリ形式 ( {xxxxxxx-xxxx ... xxxx })] オプション ボタンをクリックし、 [コピー] をクリックし、 [終了] をクリックします。
生成された GUID/UUID を、アプリケーションのapp_manifest.json ファイルのComponentId
フィールドに貼り付けます。 例: "ComponentId": "a5e23798-9bef-4bb0-9ae9-45643e788cb7"
コンポーネント ID を検索する
アプリケーションを識別するには、アプリケーションのコンポーネント ID が必要です。 アプリケーションのコンポーネント ID は、次の方法で確認できます。
- アプリケーションのapp_manifest.json ファイルの
ComponentId
フィールドでコンポーネント ID を確認します。 - コマンド azsphere device app show-status を使用して、接続されているデバイス上のアプリケーションの状態とコンポーネント ID を一覧表示します。
- コマンド azsphere device image list-installed を使用して、接続されているデバイス上の現在のイメージを一覧表示します。 必要なアプリケーションのコンポーネント ID をメモします。