お使いのIDEで作業する

ローカルで構築したコード化されたアプリを UiPath CLI を使用して Studio Web にプッシュし、同期が必要なときに、最後にプッシュされたソースをローカル フォルダーにプルし直します。

コード化されたアプリのソース コードはローカルで作成されるため、ほとんどの作業は独自の IDE で行われます。UiPath CLI は、次の 2 つのコマンドを使用して、そのローカル ワークフローを Studio Web プロジェクトに橋渡しします。

• uip codedapp push — ローカルで構築したアプリを Studio Web プロジェクトにアップロードします。
• uip codedapp pull — 最後にプッシュしたソースを Studio Web プロジェクトからローカル フォルダーに取得します。

最初のプッシュの前に引っ張る必要はありません。ローカル プロジェクトの準備ができている場合は、プロジェクトを直接プッシュします。プロジェクト ID が指定されていない場合、 push は、Studio Web で新しいコード化されたアプリ プロジェクトを作成するよう対話形式でプロンプトを送信し、生成された UIPATH_PROJECT_ID を保存して、後でプッシュできるように .env します。

前提条件

• Node.js 20.x 以降。
• UiPath CLI です。npm install -g @uipath/cliを使用してグローバルにインストールします。
• 対象の UiPath 組織 ( uip login) に対して認証します。これにより、CLI が読み取る UIPATH_ORG_ID、UIPATH_TENANT_ID、および UIPATH_ACCESS_TOKENの.envファイルが作成されます。
• Studio Web のソリューション内ですでに初期化されている (または対話 push で作成できる) コード化されたアプリ プロジェクト。詳しくは、「 コード化されたアプリ プロジェクトを初期化する」をご覧ください。

ローカルに構築されたアプリをプッシュする

プロジェクトのルートから、ビルド出力 (例: npm run build) を生成した後、次のコマンドを実行します。

uip codedapp push --project-id <project-id>

コマンドは、ビルドの出力ディレクトリ (既定では dist) を Studio Web プロジェクトにアップロードします。

UIPATH_PROJECT_IDが .envで設定されている場合 (以前の自動作成から、または手動で)、このフラグを省略できます。

uip codedapp push

オプション

オプション	説明	既定 (Default)
--project-id <id>	Studio Web プロジェクト ID です。	.envの UIPATH_PROJECT_ID から読み取る。存在しない場合は対話形式で自動作成されます。
--build-dir <dir>	アップロードする出力ディレクトリを構築します。	dist
--ignore-resources	アプリによって参照されるリソースのインポートはスキップします。	false
--verbose	詳細な進行状況ログを表示します。	false

プッシュ時、Studio Web:

• すべてのファイルをプッシュされたパスに保存し、プロジェクトの [ ソース ] ビューに読み取り専用モードで表示します。
• プッシュされたコンテンツのルートに が存在する場合は bindings_v2.jsonを読み取り、宣言された各リソースをプロジェクトの [ リソース] パネルに登録します。

最後にプッシュされたソースをプルする

pull は、最後にプッシュされたソースをローカル フォルダーに戻す必要がある場合 (チームメイトが変更をプッシュした後や、ローカルの作業コピーをリセットする場合など) に使用します。

uip codedapp pull --project-id <project-id> --target-dir ./my-coded-app

オプション

オプション	説明	既定 (Default)
--project-id <id>	Studio Web プロジェクト ID です。	.envの UIPATH_PROJECT_ID から読み取る。
--target-dir <dir>	プルされたファイルの書き込み先のローカル ディレクトリです。	現在のディレクトリ。
--overwrite	プロンプトを表示せずに既存のファイルを上書きする	false
--verbose	詳細な進行状況ログを表示します。	false

このコマンドは、最後にプッシュされたコンテンツを、プッシュされたとおりにターゲット フォルダーに書き込みます。

注:

uip codedapp pull は、プッシュされたファイルを取得します。ローカルにキャッシュされた依存関係やビルド ツールは取得しません。アプリを実行する前に、プル後に依存関係 ( npm installなど) を再インストールします。

同じプロジェクトでチームメイトと作業する

コード化されたアプリ プロジェクトには、組み込みの結合メカニズムがありません。2 人の開発者が同じプロジェクトに並行してプッシュした場合、2 番目のプッシュによって 1 番目のプッシュが上書きされます。安全に調整するには:

• Studio Web プロジェクトではなく、Git をソース コードの信頼できる情報源として扱います。
• 既知の Git コミットから Studio Web にプッシュします。制御されたリリース フローの一部として行うのが理想的です。
• uip codedapp pull を使用して、上書きする前に Studio Web でプッシュされた内容を調べます。

完全な CLI リファレンスについては、「uip codedapp push と uip codedapp pull」をご覧ください。