ohos-app-build-debug

OHOS アプリのビルドとデバッグ

このスキルを使用する場面

ユーザーがHarmonyOS/OpenHarmonyアプリを扱う必要がある場合に、このスキルを使用します。

• ビルド：「OHOSアプリをビルドして」「プロジェクトをコンパイルして」「hvigorwを実行して」
• インストール：「このHAPをインストールして」「デバイスにデプロイして」「アプリをデバイスにインストールして」
• 起動：「アプリを起動して」「アプリケーションを開始して」「デバイスで実行して」
• デバッグ：「スクリーンショットを撮って」「クラッシュスタックを解析して」「クラッシュをデバッグして」
• 環境：「DevEco Studioを確認して」「SDKのパスを表示して」「ツールを確認して」「環境を検出して」

クイックスタート

OHOSアプリをビルド、インストール、起動します。

# Run scripts from skill directory
python3 $SKILL_DIR/scripts/build.py
python3 $SKILL_DIR/scripts/install.py -f entry/build/default/outputs/default/entry-default-signed.hap
python3 $SKILL_DIR/scripts/launch.py

同梱リソース

このスキルには、DevEco Studio環境を自動検出する実行可能なスクリプトが scripts/に含まれています。

スクリプト	目的
build.py	hvigorwを使用してOHOSアプリをビルドします
install.py	接続済みデバイスにHAPファイルをインストールします
launch.py	インストール済みアプリを起動します
screenshot.py	デバイスのスクリーンショットをキャプチャします
parse_crash.py	hstackを使用してクラッシュスタックを解析します
env_detector.py	DevEco Studioとツールを検出します
ohos_utils.py	共通ユーティリティ関数

コマンドの詳細については、references/command-reference.mdを参照してください。

一般的なワークフロー

ビルドとインストール

# 1. Check environment
python3 $SKILL_DIR/scripts/env_detector.py

# 2. Build the application
python3 $SKILL_DIR/scripts/build.py

# 3. Install to device (output from build.py shows HAP path)
python3 $SKILL_DIR/scripts/install.py -f entry/build/default/outputs/default/entry-default-signed.hap

# 4. Launch the app
python3 $SKILL_DIR/scripts/launch.py

ビルド、インストール、起動を1行で実行

python3 $SKILL_DIR/scripts/build.py && \
python3 $SKILL_DIR/scripts/install.py -f $(find entry/build -name "*.hap" | head -1) && \
python3 $SKILL_DIR/scripts/launch.py

デバッグワークフロー

# Launch app
python3 $SKILL_DIR/scripts/launch.py

# Take screenshot to verify
python3 $SKILL_DIR/scripts/screenshot.py -o ./screenshots

クラッシュ解析

# Parse crash stack from file
python3 $SKILL_DIR/scripts/parse_crash.py -f crash.txt

# Parse from string
python3 $SKILL_DIR/scripts/parse_crash.py -c "stack trace here"

仕組み

環境の自動検出

すべてのスクリプトはDevEco Studioのインストールを自動検出し、環境を設定します。

1. DevEco Studioの検出

   • Windows：C:\Program Files\Huawei\DevEco Studio\
   • macOS：/Applications/DevEco-Studio.app/
   • Linux：~/DevEco-Studio/または/opt/DevEco-Studio/

2. ツールチェーンの設定

   • JAVA_HOMEをDevEcoにバンドルされているJBRに設定します
   • SDKツールをPATHに追加します
   • HDC_SERVER_PORT=7035を設定します
   • 検出結果を24時間キャッシュします

3. 自動検出されるツール

   • コア：hdc、hvigorw、java
   • LLVM：clang、clang++、lld、llvm-*
   • プロファイラー：hiprofiler、hiperf
   • その他：hstack、ohpm、idl、restool、syscap_tool

応答ガイドライン

OHOS開発についてユーザーをサポートする場合：

1. スキルディレクトリを特定する

   • $SKILL_DIRを実際のスキルのインストールパスに置き換えます
   • 一般的な場所：~/.claude/skills/ohos-app-build-debugまたはプロジェクト固有のパス

2. スクリプトを実行する

   • scripts/ディレクトリ内のPythonスクリプトを絶対パスまたは相対パスで呼び出します
   • スクリプトの実行前に、必ずOHOSプロジェクトのディレクトリに移動します

3. まず環境を表示する

   • 初回のビルド時にenv_detector.pyを実行して、利用可能なツールを表示します

4. 1行コマンドを提示する

   • ユーザーの利便性に応じて、ビルド、インストール、起動をまとめます

5. 実際のコマンドを表示する

   • 透明性を確保するため、実行されるhvigorw/hdcコマンドを表示します

6. エラーに適切に対処する

   • コマンドが失敗した場合は、トラブルシューティングの手順を提示します
   • 詳細についてはreferences/troubleshooting.mdを参照してください

7. プロジェクトのコンテキストを活用する

   • プロジェクト構成からバンドル名とパスを自動検出します

エラー処理

DevEco Studioが検出されない場合：

• DevEco Studioがインストールされていることを確認します
• 標準のインストールパスを確認します
• 環境変数DEVECO_STUDIO_PATHを設定します

デバイスが接続されていない場合：

• USBケーブルの接続を確認します
• デバイスでUSBデバッグが有効になっていることを確認します
• プロンプトが表示されたら、デバイスでUSBデバッグを許可します

詳しいトラブルシューティングについては、references/troubleshooting.mdを参照してください。

前提条件

• DevEco Studio 3.1以降（4.0以降を推奨）
• USBデバッグが有効なOHOSデバイス
• スクリプトの実行に必要なPython 3.7以降

DevEco Studioをダウンロード：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-download