コード化されたアプリを構築してデプロイする

UiPath でコード化されたアプリを構築してデプロイする: 開始する前の必要条件、IDE でのアプリの作成方法、Orchestrator フォルダーへのパブリッシュとデプロイの方法。

コード化されたアプリは、開発者が独自の IDE で記述した Web アプリケーションとして始まり、ユーザーが UiPath の URL から開くアプリとして終わります。このページでは、その過程と、UiPath で実行されるデプロイ手順について説明します。

このプロセスには 4 つの段階があります。

1. IDE でアプリ ロジックを定義する
2. セキュリティで保護された UiPath への接続を確立する
3. Orchestrator にアプリをデプロイする
4. UiPath エコシステム内でアプリにアクセスする

はじめる前に

重要:

Automation Cloud (専有型) および Test Cloud (専有型) では、専有型の運用環境が 2026 年 9 月 24 日付の Apps リリースにアップグレードされるまでは、pack、publish、deploy、push の手順に UiPath CLI バージョン 1.202.0 を使用します。新しいバージョンの CLI には、現在専用環境で実行されている Apps のバージョンに対応していない重大な変更が含まれています。専用の運用環境を 2026 年 9 月 24 日の Apps リリースにアップグレードした後は、新しいバージョンの UiPath CLI を使用できます。

トラブルシューティングについては、「 Automation Cloud (専有型) で uip codedapp コマンドが失敗するのはなぜですか?」をご覧ください。

次の条件が整っていることを確認します。

• Node.js 20.x 以降と npm を使用したローカル開発環境で、アプリの構築と UiPath ツールのインストールに使用されます。nodejs.org からインストーラーをダウンロードします。このインストーラーには npm が含まれます。既にインストールされているものを確認するには、 node -v を実行して npm -v。
• codedapp ツールがインストールされている UiPath CLIインストールの手順については、 『UiPath CLI ガイド』をご覧ください。
• 組織に登録されている外部アプリケーションの外部アプリ ID。アプリはこのキーを使用してユーザーをサインインさせ、ユーザーに代わって UiPath サービスを呼び出します。コード化されたアプリはブラウザーで実行され、アプリ シークレットを保存できないため、ユーザー スコープを持つ 非機密アプリケーション として登録してください。外部アプリケーションを登録するには、『Automation Cloud 管理ガイド』の「 外部アプリケーションを追加する 」をご覧ください。
• 対象の Orchestrator フォルダーにパッケージをパブリッシュし、アプリをデプロイする権限。

アプリを構築する

開発者は、React、Vue、Angular などの選択したフレームワークで、Web アプリケーションを構築するのと同じ方法でアプリを構築します。UiPath は、このワークフローに次の 2 つの機能を追加します。

• 組織へのコネクションプロジェクトのルートにある構成ファイルにより、組織、テナント、外部アプリ ID を識別します。UiPath TypeScript SDK はこの構成を読み取ることで、アプリは Orchestrator、アセット、ストレージ バケット、プロセスなどの UiPath サービスを呼び出すことができます。
• ローカル開発の設定。プロジェクトのビルド ツール用の UiPath プラグインは、アプリを開発者のマシンで実行している間に同じ構成を提供するため、アプリをデプロイする前に実際のテナントに対してテストできます。

どちらもプロジェクトごとに 1 回限りの設定です。構成ファイル、ビルド ツール プラグイン、アプリをパッケージ化する前に必要な調整など、開発者向けの完全な設定については、SDK ドキュメントの「 コード化された Apps の利用を開始する 」をご覧ください。

アプリをデプロイする

デプロイは 2 つのパートに分かれて行われます。開発者がアプリをパッケージ化してパブリッシュしてから、そのパッケージを Orchestrator フォルダーにデプロイします。

アプリをパッケージ化してパブリッシュする

コード化されたアプリは、オートメーションで使用されるパッケージ形式と同じ .nupkg パッケージとして Orchestrator にパブリッシュされます。

1. アプリを構築します。

   npm run build
   

2. ビルド出力をパッケージ化します。

   uip codedapp pack dist -n <appName> --version 1.0.0
   

3. UiPath 組織にサインインします。

   uip login
   

4. パッケージをテナント フィードまたは個人用ワークスペース フィードにパブリッシュします。

   uip codedapp publish
   

5. アプリをデプロイします。

   uip codedapp deploy
   

各コマンドの完全な引数のリストについては、『UiPath CLI ガイド』の「uip codedapp」をご覧ください。

Orchestrator からアプリをデプロイする

パッケージがすでにパブリッシュされている場合、またはコマンド ラインを使用しない場合は、代わりに Orchestrator からアプリをデプロイします。

1. Orchestrator で [ テナント ] > [パッケージ] に移動します。
2. [アップロード] を選択し、uip codedapp packが作成した .nupkg ファイルをアップロードします。詳しい手順については、「 パッケージを管理する」をご覧ください。
3. アプリをデプロイするフォルダーに移動し、[ オートメーション] > Apps] に移動します。
4. [ アプリをデプロイ] を選択し、アプリとそのバージョンを選択します。詳しい手順については、「 アプリを管理する」をご覧ください。

Studio Web からアプリをデプロイする

アプリが Studio Web ソリューション内にコード化されたアプリ プロジェクトとして構築されている場合、そのアプリは単独でではなく、そのソリューションと一緒にパッケージ化およびデプロイされます。コード化されたアプリのバージョンは、依存するワークフロー、エージェント、リソースと歩調を合わせています。

1. アプリをローカルでビルドしてから、Studio Web プロジェクトにプッシュします。

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

2. Studio Web でソリューションを開き、[ デプロイ] を選択します。

3. パッケージ バージョンを設定し、個人用ワークスペースにパッケージ化するか共有ワークスペースにパッケージ化するかを選択します。デプロイに名前を付け、フォルダーを選択して [ デプロイ] を選択します。

[デプロイ] パネルのオプションの完全なセットについては、『Studio Web ガイド』の「 ソリューションをパブリッシュしてデプロイする 」をご覧ください。

アプリが https://<orgName>.uipath.host/<appName>で利用可能になります。