1k-dev-commands

OneKey 開発コマンド

ブランチの命名、コミット形式、リベース、PR の規約については、git-workflow.mdをお読みください。

アプリケーション開発コマンド

プラットフォーム固有の開発：

• yarn app:desktop - Rspack を使用してデスクトップ Electron アプリの開発を開始します

  • 実行時間：起動まで 30～60 秒
  • よくある問題：Node のバージョンの競合、ネイティブ依存関係の不足
  • トラブルシューティング：起動に失敗した場合は、yarn clean && yarn reinstall を実行します

• yarn app:web:rspack - Web 開発サーバーを起動します（ポート 3000）

  • 実行時間：起動まで 15～30 秒
  • よくある問題：ポート 3000 がすでに使用中、Rspack のコンパイルエラー
  • トラブルシューティング：ポート 3000 の既存プロセスを終了し、コンソールで具体的なエラーを確認します

• yarn app:ext - Rspack を使用してブラウザー拡張機能の開発を開始します

  • 実行時間：起動まで 20～40 秒
  • よくある問題：Manifest v3 の検証エラー、権限の問題
  • トラブルシューティング：拡張機能のマニフェストが有効か確認し、コンテンツセキュリティポリシーを確認します

• Mobile DevSession launcher - 通常の iOS／Android React Native 開発で使用するデフォルトのパスです。 アプリの起動、シェル／ベンダーリソースの復元、または UI ツールの接続を行う前に、このガイドをお読みください。

• yarn app:ios - Mobile DevSession launcher を通じて iOS 開発を開始します

  • 実行時間：1～2 分（Metro bundler を含む）
  • よくある問題：Xcode のセットアップ、シミュレーターの問題、Pod のインストール失敗
  • 前提条件：Xcode がインストール済みで、iOS シミュレーターが利用可能であること

• yarn app:android - Mobile DevSession launcher を通じて Android 開発を開始します

  • 実行時間：1～2 分（Metro bundler を含む）
  • よくある問題：Android SDK のパス、エミュレーターのセットアップ、Gradle のビルド失敗
  • 前提条件：Android Studio と SDK ツールがあり、エミュレーターが設定済みであること

• ローカルでネイティブビルドを直接行う場合：yarn workspace @onekeyhq/mobile ios および yarn workspace @onekeyhq/mobile android。明示的に要求された場合、またはランチャーの診断を行う場合に限り使用してください。

• yarn app:web-embed - 埋め込み可能なコンポーネントの開発を開始します

  • 実行時間：15～30 秒
  • 用途：スタンドアロンのウォレットコンポーネントの開発に使用します

ビルドコマンド

本番ビルド（最終検証に使用）：

• yarn app:desktop:build - すべてのプラットフォーム向けにデスクトップアプリをビルドします

  • 実行時間：5～10 分（マルチプラットフォームビルド）
  • 出力：プラットフォーム固有のインストーラー（apps/desktop/dist/ 内）
  • よくある問題：コード署名、プラットフォーム固有の依存関係
  • 検証：対象プラットフォームでインストーラーをテストします

• yarn app:ext:build - ブラウザー拡張機能をビルドします

  • 実行時間：2～3 分
  • 出力：展開済みの拡張機能（apps/ext/build/chrome_v3/ 内）
  • よくある問題：マニフェストの検証、コンテンツセキュリティポリシー違反
  • 検証：テストのために拡張機能をブラウザーに読み込みます

• yarn app:web:build - Web アプリケーションをビルドします

  • 実行時間：3～5 分
  • 出力：静的ファイル（apps/web/dist/ 内）
  • よくある問題：バンドルサイズの上限、環境変数の不足
  • 検証：ビルドしたファイルを配信し、機能をテストします

• yarn app:native-bundle - React Native アプリをバンドルします

  • 実行時間：3～5 分
  • 出力：プラットフォーム固有のバンドル
  • よくある問題：ネイティブモジュールのリンク、Metro bundler のエラー
  • 前提条件：プラットフォームの開発環境が適切に設定されていること

開発ツールと品質保証

コミット前コマンド（ローカル開発）

エージェントによる迅速なコミット前検証に使用します：

• yarn agent:check --profile commit - ステージ済みの lint と型チェックを簡潔な出力で実行します

コミット前のワークフロー：

yarn agent:check --profile commit && git commit -m "your message"

CI コマンド（プロジェクト全体のチェック）

CI パイプラインまたは包括的な検証で実行します。

• yarn lint - 包括的なリント（TypeScript、oxlint、フォルダー構成、i18n）
  • 想定実行時間：約1分
  • 許容範囲ゼロ：すべての警告とエラーを必ず修正してください
  • 用途：CI パイプラインおよび PR 前の包括的なチェック
• yarn eslint、npx eslint、node_modules/.bin/eslint は実行しないでください。 ESLint の項目はレガシー互換性のための名残です。現在のリント検証では、 agent:check または yarn lint を通じて oxlint を使用します。
• yarn test - Jest テストの実行
  • 用途：CI パイプラインおよびテストの検証

その他のツール

• yarn clean - すべてのビルド成果物と node_modules をクリーンアップします
• yarn reinstall - クリーンインストールを完全に実行します（依存関係の問題が発生した場合に使用します）

テスト

• Jest の設定は jest.config.js にあります
• テストのセットアップは jest-setup.js にあります
• テストは、パッケージ内の @tests/ ディレクトリにあります
• モバイルテストでは jest-expo プリセットを使用します