プロジェクト 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 つのワークスペースしか使用できません。Google デベロッパー プロフィールをお持ちの場合は、最大 5 つのワークスペースを作成できます。ワークスペースの上限に達した後に IDX から直接 Google デベロッパー プロファイルを作成するには、テンプレート ダッシュボードの通知で [設定を完了] をクリックします。

ワークスペースは読み込まれるが、エミュレータは空白になる

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. アクティビティ バー（デフォルトでは左側）の Project 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 プロダクトを GitHub で開発しています。

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

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

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

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

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

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

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

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

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