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

ヒント: 質問の回答が見つからない場合は、コミュニティ フォーラムで質問するか、機能リクエストを送信してください。

ワークスペースを開くと、「リクエストをバックエンドに転送できません。ポート 80 のサーバーに接続できませんでした。

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

プレビューが機能しないが、コードに問題は見当たらない。IDX を再起動するにはどうすればよいですか？

IDX が正しく更新されない場合は（通常、大規模なリファクタリングや環境の dev.nix ファイルの変更が原因）、コマンド パレットを開き（Mac の場合は Cmd+Shift+P、ChromeOS、Windows、Linux の場合は Ctrl+Shift+P）、ハードリブート コマンドを実行します。それでも問題が解決しない場合は、Rebuild Environment コマンドを実行してみてください。

ワークスペースの作成中に、「Whoops.. 新しい VM を起動する必要があります。その後、UI がハングします。

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

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

ワークスペースのプロビジョニング中に内部エラーが発生した場合、ほとんどの場合、1 分後にページを更新するとエラーが解消され、ワークスペースが表示されます。

アカウントに何種類のワークスペースを 作成できますか？

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

ワークスペースは読み込まれますが、エミュレータは空白です。

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

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

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

Google は、IDX での Flutter バージョン管理の改善に積極的に取り組んでいます。

Project IDX と Google Cloud Workstations の違いは何ですか？

IDX は、Google Cloud の一般提供の Cloud Workstations サービス上に構築されています。Cloud Workstations は、デベロッパー ワークステーションの信頼性、セキュリティ、可用性に重点を置いたインフラストラクチャ サービスです。

開発エクスペリエンスを管理したい大企業に最適です。Project IDX は、これらのワークステーション内の「バッテリー内蔵」環境であり、さまざまなアプリケーション タイプのビルドに必要なツールチェーン、ソフトウェア開発スタック、システム依存関係を管理します。

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

IDX では、あるドメイン（cloudworkstations.dev のサブドメイン）の IFRAME を別のドメイン（idx.google.com）にレンダリングするため、サードパーティ Cookie を有効にする必要があります。サードパーティ Cookie は、クロスオリジン通信を安全に行うことができます。

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

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

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

ワークスペースに追加されたユーザーは、VM のファイル システム全体に完全にアクセスできます。このファイル システムには、秘密鍵やアクセス トークンなどの機密ファイルが含まれている場合があります。ワークスペースは信頼できるユーザーとのみ共有してください。この方法では、他のユーザーがワークスペースの正確な状態を確認できますが、ワークスペース上のすべての内容が公開されます。

IDX にテンプレートがないフレームワークを使用してアプリケーションを構築できますか？

はい。IDX では、ほぼすべてのフレームワークや言語に対応するように環境をカスタマイズできます。

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

現時点では、GitHub、GitLab、Bitbucket からのプロジェクトのインポートをサポートしています。サポート対象の Git ホストを増やすには、機能リクエストを送信してください。

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

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

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

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

バックエンド サーバーが実行されている TCP ポートを一時的に一般公開すると、さまざまなワークスペースでフロントエンドとバックエンドを別々に開発しやすくなります。

1. バックエンド サーバーまたは API サーバーを、ターミナルで手動で、または dev.nix ファイルのプレビュー構成または onStart ライフサイクル フックの一部として起動します。

2. アクティビティ バー（デフォルトでは左側）の [プロジェクト IDX] アイコンをクリックして [IDX] パネルを開きます。

3. 

   [バックエンド ポート] セクションを開き、実行中のサーバーのリスト（ポート番号とプロセス ID（PID）を含む）を表示します。

4. ポート番号の左側にある 公開アイコン（ロック）をクリックします。

   警告: これにより、ワークスペースがアクティブな間、かつ公開アクセスを明示的にオフにするまで、インターネット上の誰でもポートにアクセスできます。

5. ポート番号の右側にある [URL をコピー] アイコンをクリックして、完全修飾 URL をコピーします。

6. これで、この URL をフロントエンドから直接（fetch 呼び出しなどで）参照できるようになりました。

   注: フロントエンドがウェブブラウザの場合は、バックエンドまたは API サーバーで CORS サポートを有効にする必要があります（Node.js アプリの場合は cors NPM パッケージ、Python Flask アプリの場合は flask-cors など）。

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

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

Code OSS とは何ですか？

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

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

IDX の Gemini を改善するために Gemini のチャット プロンプトをトレーニング データとして使用したくない場合は、チャット アシスタントを使用せず、ワークスペースの [設定] でコード補完をオフにします。特定のファイルで作業するときにアシスタントをオフにするには、.aiexclude ファイルをリポジトリに追加します。

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

プロジェクト IDX の使用中に問題が発生した場合は、フォーラムで質問するか、バグを報告してください。

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

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

IDX の Gemini は一部の国 / 地域で利用できます。利用可能な国 / 地域は定期的に拡大されます。IDX の Gemini がご利用の地域で利用可能な場合は、Gemini をワークスペースに追加するの手順に沿って使用を開始できます。

Project IDX の特定の機能を使用していたが、その機能が見つかりません。削除されたのはどうしてですか？

Project IDX の一部の機能は試験運用版です。Google は皆様からのご意見を重視しており、現在の機能や計画されている機能の参考に積極的に活用しています。また、ユーザーや Google の期待に沿わない機能は定期的に削除しています。理想的なバージョンの Project IDX に追加してほしい機能がある場合は、フィードバックを送信してください。皆様のご意見をお寄せください。