プロジェクト IDX のトラブルシューティングとよくある質問

ワークスペースを開くと、「Unable to forwarding your request to backend. ポート 80 でサーバーに接続できませんでした。

これは既知の問題です。回避策として、約 5 秒待ってからページを更新します。

プレビューが破損していますが コードに問題はありませんIDX を再起動するにはどうすればよいですか？

IDX が正しく更新されない場合（通常は主要なリファクタリングや monospace.json ファイルの変更が原因）、IDX カテゴリのコマンド パレット（Mac では Cmd+Shift+P、ChromeOS、Windows、Linux では Ctrl+Shift+P）にあるハードリスタートを実行します。

ワークスペースの作成中に [エラー新しい VM をスピンアップする必要があり、その後 UI がハングします。

IDX は、ワークスペースをオンデマンドでプロビジョニングするために使用される VM のウォームプールを維持します。プールの残量が少なくなると、新しい VM がスピンされた後にワークスペースがプロビジョニングされます。このプロセスには時間がかかることがありますが（5 分ほどかかる場合があります）、最終的には成功します。

ワークスペースの作成中に、「内部エラーが発生しました」というメッセージが表示される

ワークスペースのプロビジョニング中の内部エラーのほとんどは、1 分後にページを更新するとエラーを無視してワークスペースに戻るはずです。

アカウントにはいくつのワークスペースを作成できますか？

IDX のワークスペースは、ユーザー 1 人につき 1 つに制限されています。Google デベロッパー プロフィールがある場合は、最大 5 つのワークスペースを作成できます。ワークスペースの上限に達した後に IDX から直接 Google デベロッパー プロフィールを作成するには、テンプレート ダッシュボードの通知から [Complete Setup] をクリックします。

ワークスペースは読み込まれるが エミュレータに何も表示されない

Google は、クラウドベースのエミュレータの信頼性の改善に積極的に取り組んでいます。ページを更新しても問題が解決しない場合は、問題を報告してください。

IDX ワークスペースの Flutter バージョンは 私のプロジェクトと互換性がありません

ローカルマシンの場合と同様に（apt-get または brew を使用して）、ワークスペース内でほぼすべてのプリインストール ソフトウェアのバージョンをアップグレードまたはダウングレードできます。「アイドル状態」のワークスペースが休止状態になると、変更は保持されないことに注意してください。

プロジェクト IDX と Google Cloud Workstations の違いは何ですか？

IDX は、Google Cloud の一般提供されている Cloud Workstations サービス上に構築されています。Cloud Workstations は、デベロッパー ワークステーションの信頼性、セキュリティ、可用性に重点を置いたインフラストラクチャ サービスです。開発エクスペリエンスを管理する大企業に最適です。プロジェクト IDX は、これらのワークステーション内の「電池が付属する」環境であり、さまざまなアプリケーション タイプをビルドするために必要なツールチェーン、ソフトウェア開発スタック、システム依存関係を管理します。

Linux には詳しくない。Project IDX で生産性を上げるには？

プロジェクト IDX は、プロジェクトのシステムレベルのソフトウェア依存関係をインストールして管理するために使用できる Debian シェルを公開しています。Google は、OS に依存しない Nix ベースのシェルにまもなく移行します。このシェルを使用すると、apt などの OS 固有のパッケージ マネージャーの詳細を理解しなくても、システム ソフトウェアの依存関係を構成として管理できます。今しばらくお待ちください。

IDX でサードパーティ（3P）Cookie を有効にする必要があるのはなぜですか？

IDX では、あるドメイン（cloudworkstations.dev のサブドメイン）から別のドメイン（idx.google.com）に iframe をレンダリングし、サードパーティ Cookie によって安全なクロスオリジン通信を可能にするため、サードパーティ Cookie を有効にする必要があります。

ワークステーションの URL を他のユーザーと共有しましたが、他のユーザーは私のワークスペースを確認できません。

ワークスペースの URL は、ワークスペースにアクセスできるユーザーとのみ共有できます。権限のないユーザーが URL にアクセスしようとすると、エラーが表示されます。 Google ドキュメントの共有など、ワークスペースを明示的に共有してください。

ワークステーションを共有すると 共同編集者は 何を閲覧できますか？

ワークスペースに追加されたユーザーは、VM のファイル システム全体に対する完全なアクセス権を持ちます。このファイル システムには、秘密鍵やアクセス トークンなどの機密ファイルが含まれている場合があります。ワークスペースは信頼できるユーザーとのみ共有してください。このアプローチは、他のユーザーがワークスペースの正確な状態を確認するのに役立ちますが、ワークスペース上のすべてのものを見ることを意味します。

Firebase 認証情報を含むワークスペースを安全に共有するにはどうすればよいですか？

IDX を使用してアプリケーションを Firebase にデプロイすると、ワークスペースにはオペレーションの実行に必要な最も基本的な権限のみがプロビジョニングされます。ユーザーはプロジェクトの管理者かもしれませんが、ワークスペース自体には、最小権限の原則に従ってオーナーになることに伴うすべての権限が付与されているわけではありません。

IDX でサポートされていないフレームワークをアプリケーションの構築に使用できるか？

いいね！Google では、ワークスペースを完全にカスタマイズできるように取り組んでいますが、サポートされていないフロントエンド フレームワークを使用しているプロジェクトや、UI をまったく備えていないプロジェクトをインポートすることは可能です。この問題を回避する最も簡単な方法は、リポジトリのインポート フローの [アプリの種類] で [その他] を選択することです。ワークスペースを設定すると、プロジェクトに必要なシステムレベルの依存関係をインストールできます。

GitLab または Cloud Source リポジトリからリポジトリをインポートできますか？

現時点では GitHub をサポートしています。さらに多くの Git ホストのサポートをご希望の場合は、機能リクエストを送信してください。

それまでの間は、ローカルマシンで通常行うように、既存のテンプレートから新しいワークスペースを作成し、ターミナルで https または ssh ベースの任意の Git ホストで git clone を実行できます。

Flutter アプリを Firebase Hosting にデプロイするときは、どのターゲット ディレクトリを選択すればよいですか？

build/web ディレクトリを選択します。このディレクトリには、index.html と、（flutter build web を介して）アプリが正常にビルドされた後にウェブアプリをレンダリングするために必要なすべての静的アセットが含まれている必要があります。

フロントエンドが通信できるように、ワークスペースにアプリのバックエンドを設定するにはどうすればよいですか？

これは近い将来に簡素化される予定ですが、現時点では次の回避策を使用してください。

1. API バックエンドがあるプロジェクトでは、ターミナルで API サービスを手動で開始するか、monospace.json ファイルで起動コマンドを構成できます。

2. ターミナルで次の bash スクリプトを実行して、API サービスが実行されているポートを開き、ウェブ フロントエンドのプレビューにアクセスできるようにします。

   export port=4000 #dont use restricted ports (8000, 9000-9002)
   export API_SERVICE="https://$port-$WEB_HOST"
   echo $API_SERVICE
   

3. ブラウザの新しいタブの上にある API_SERVICE URL を開きます。これにより、リダイレクト フローを通じて必要な Cookie が設定されます。

4. これで、ウェブアプリのフロントエンドが完全修飾パスで API サービスにアクセスできるようになりました。

プレビュータブを閉じました元に戻すにはどうすればよいですか？

コマンド パレットを開き（Mac では Cmd+Shift+P、ChromeOS、Windows、Linux では Ctrl+Shift+P）、[Project IDX: Show Web Preview] を選択します。

コード OSS とは

Code-Open Source Software（Code-OSS）は、VS Code のコアレイヤであるオープンソース プロジェクトです。Code-OSS は、標準の MIT ライセンスの下で GitHub で利用可能で、Microsoft は VS Code プロダクトを開発しています。

コード補完と Gemini チャット プロンプトがトレーニング データとして使用されないようにするにはどうすればよいですか？

Gemini チャット プロンプトをトレーニング データとして使用して IDX の Gemini を改善したくない場合は、チャット アシスタントを使用せず、ワークスペースの設定でコード補完をオフにします。

発生した問題に関する機能リクエストやフィードバックを送信するにはどうすればよいですか？

Project IDX の使用中に問題が発生した場合は、バグを報告してお知らせください。

IDX に追加したい機能、または拡張したい既存の機能がある場合は、機能リクエストを提出してください。

IDX は、バグや機能リクエストに IssueTracker を使用し、スクリーンショットと動画による堅牢なリクエストをサポートしています。将来的には、IDX は UserVoice を通じてフィードバックと機能を追跡する可能性があります。すでに UserVoice を通じて送信されたフィードバックやリクエストは保存され、チームと共有されます。

IDX の Gemini が自分の国または地域で利用できるかどうかを確認するには、どうすればよいですか？

IDX の Gemini は一部の地域でのみ提供され、提供地域は随時拡大しています。IDX の Gemini がお住まいの地域で利用できる場合は、Gemini をワークスペースに追加するに記載された手順に沿ってワークスペースに追加できます。

Project IDX の特定の機能を使用しましたが 見つかりません削除されたのはなぜですか？

Project IDX の機能の一部は試験運用版です。お寄せいただいたフィードバックは Google の現在および計画中の機能セットに反映し、お客様のご期待に添えない機能を定期的に削除しております。理想的なバージョンの Project IDX に機能を実装してほしい機能がある場合は、フィードバックをお送りください。皆様のご意見をお寄せください。