프로젝트 IDX 문제 해결 및 FAQ

도움말: 질문에 대한 답변을 찾을 수 없는 경우 커뮤니티 포럼에 질문하거나 기능 요청을 제출하세요.

작업공간을 여는 동안 요청을 백엔드로 전달할 수 없습니다. 포트 80에서 서버에 연결할 수 없습니다.

이러한 경우는 드물지만 해결 방법으로 약 5초 정도 기다린 후 페이지를 새로고침할 수 있습니다.

미리보기가 손상되었지만 코드에는 문제가 없습니다. IDX를 다시 시작하려면 어떻게 해야 하나요?

IDX가 제대로 새로고침되지 않는 경우 (일반적으로 대규모 리팩터링 또는 환경 dev.nix 파일 변경으로 인한 경우) 명령어 팔레트 (Mac의 경우 Cmd+Shift+P, ChromeOS, Windows, Linux의 경우 Ctrl+Shift+P)를 열고 강제 재시작 명령어를 실행합니다. 그래도 문제가 해결되지 않으면 환경 재빌드 명령어를 실행해 보세요.

작업공간을 만드는 동안 앗.. 새 VM을 시작해야 합니다. 그 후 UI가 중단됩니다.

IDX는 주문형으로 워크스페이스를 프로비저닝하는 데 사용되는 VM의 따뜻한 풀을 유지합니다. 풀이 부족해지면 새 VM이 스핀된 후에 워크스페이스가 프로비저닝됩니다. 이 프로세스는 시간이 걸릴 수 있지만 (최대 5분) 결국 완료됩니다.

워크스페이스를 만드는 동안 내부 오류가 발생이라는 메시지가 표시됨

작업공간 프로비저닝 중에 내부 오류가 발생하는 대부분의 경우, 1분 정도 후에 페이지를 새로고침하면 오류를 지나 작업공간으로 이동할 수 있습니다.

계정에 몇 개의 워크스페이스를 만들 수 있나요?

IDX는 사용자당 워크스페이스가 하나로 제한됩니다. Google 개발자 프로필이 있는 경우 최대 5개의 워크스페이스를 만들 수 있습니다. 작업공간 한도가 도달한 후 IDX에서 직접 Google 개발자 프로필을 만들려면 템플릿 대시보드의 알림에서 설정 완료를 클릭합니다.

작업공간이 로드되지만 에뮬레이터가 비어 있음

Google은 클라우드 기반 에뮬레이터의 안정성을 적극적으로 개선하고 있습니다. 페이지를 새로고침해도 문제가 해결되지 않으면 문제를 신고하세요.

IDX 작업공간에 내 프로젝트와 호환되지 않는 Flutter 버전이 있습니다

로컬 머신에서 apt-get 또는 brew를 사용하는 것처럼 워크스페이스 내에서 거의 모든 사전 설치된 소프트웨어의 버전을 업그레이드하거나 다운그레이드할 수 있습니다. '유휴' 워크스페이스가 최대 절전 모드로 전환되면 변경사항이 유지되지 않습니다.

Google은 IDX의 Flutter 버전 관리를 개선하기 위해 노력하고 있습니다.

Project IDX와 Google Cloud Workstations의 차이점은 무엇인가요?

Google Cloud의 놀라운 일반 공개 Cloud Workstations 제품을 기반으로 IDX를 빌드했습니다. Cloud Workstations는 개발자 워크스테이션의 안정성, 보안, 가용성에 중점을 둔 인프라 제품입니다.

개발 환경을 관리하려는 대기업에 이상적인 선택입니다. 프로젝트 IDX는 이러한 워크스테이션 내의 '배터리 포함' 환경으로, 다양한 애플리케이션 유형을 빌드하는 데 필요한 도구 모음, 소프트웨어 개발 스택, 시스템 종속 항목을 관리합니다.

IDX에 서드 파티 (3P) 쿠키가 사용 설정되어야 하는 이유는 무엇인가요?

IDX는 한 도메인 (cloudworkstations.dev의 하위 도메인)의 IFRAME을 다른 도메인 (idx.google.com)에 렌더링하기 때문에 서드 파티 쿠키가 사용 설정되어야 하며 서드 파티 쿠키는 안전한 교차 출처 통신을 사용 설정합니다.

워크스테이션 URL을 다른 사용자와 공유했는데 내 워크스페이스가 표시되지 않습니다.

워크스페이스 URL은 워크스페이스에 액세스할 수 있는 사용자와만 공유할 수 있습니다. 권한이 없는 사용자는 URL을 방문하려고 하면 오류가 표시됩니다. Google 문서를 공유하는 것처럼 워크스페이스를 명시적으로 공유해야 합니다.

워크스테이션을 공유하면 공동작업자가 무엇을 볼 수 있나요?

워크스페이스에 추가된 사용자는 비공개 키 및 액세스 토큰과 같은 민감한 파일이 포함될 수 있는 VM의 전체 파일 시스템에 대한 전체 액세스 권한을 갖습니다. 신뢰할 수 있는 사용자와만 워크스페이스를 공유하세요. 이 접근 방식을 사용하면 다른 사용자가 내 작업공간의 정확한 상태를 볼 수 있지만, 내 작업공간의 모든 항목이 표시된다는 의미입니다.

IDX에 템플릿이 없는 프레임워크를 사용하여 애플리케이션을 빌드할 수 있나요?

예. IDX에서는 거의 모든 프레임워크 또는 언어로 작동하도록 환경을 맞춤설정할 수 있습니다.

GitLab 또는 Cloud Source 저장소에서 내 저장소를 가져올 수 있나요?

현재 GitHub, GitLab, Bitbucket에서 프로젝트를 가져오는 기능이 지원됩니다. 더 많은 Git 호스트를 지원하도록 하려면 기능 요청을 제출하세요.

그동안은 기존 템플릿에서 새 작업공간을 만들고, 로컬 머신에서 일반적으로 하는 것처럼 터미널에서 https 또는 ssh 기반 Git 호스트로 git clone를 실행할 수 있습니다.

Firebase 호스팅에 Flutter 앱을 배포할 때 어떤 타겟 디렉터리를 선택해야 하나요?

build/web 디렉터리를 선택합니다. 이 디렉터리에는 index.html 및 앱이 빌드된 후 flutter build web를 통해 웹 앱을 렌더링하는 데 필요한 모든 정적 애셋이 포함되어야 합니다.

프런트엔드가 앱의 백엔드와 통신할 수 있도록 워크스페이스에서 앱의 백엔드를 설정하려면 어떻게 해야 하나요?

백엔드 서버가 실행 중인 TCP 포트를 일시적으로 공개적으로 열어 여러 워크스페이스에서 프런트엔드와 백엔드를 별도로 더 쉽게 개발할 수 있습니다.

1. 터미널에서 수동으로 또는 dev.nix 파일의 미리보기 구성 또는 onStart 수명 주기 후크의 일부로 백엔드 또는 API 서버를 시작합니다.

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를 선택합니다.

코드 OSS란 무엇인가요?

Code-Open Source Software (Code-OSS)는 VS Code의 핵심 레이어인 오픈소스 프로젝트입니다. Code-OSS는 표준 MIT 라이선스에 따라 GitHub에서 제공되며 Microsoft에서 VS Code 제품을 개발하는 곳입니다.

코드 완성 및 Gemini 채팅 프롬프트가 학습 데이터로 사용되지 않도록 하려면 어떻게 해야 하나요?

IDX에서 Gemini를 개선하기 위해 Gemini 채팅 프롬프트를 학습 데이터로 사용하지 않으려면 채팅 어시스턴트를 사용하지 말고 워크스페이스 설정에서 코드 완성 기능을 사용 중지하세요. 저장소에 .aiexclude 파일을 추가하여 특정 파일을 사용할 때 지원을 사용 중지할 수도 있습니다.

발생한 문제에 관한 기능 요청 또는 의견을 제출하려면 어떻게 해야 하나요?

Project IDX를 사용하는 동안 문제가 발생하면 포럼에 질문을 올리거나 버그를 신고하세요.

IDX에 추가하고 싶은 기능이 있거나 기존 기능을 확장하고 싶다면 기능 요청을 제출하세요.

거주 국가 또는 지역에서 IDX의 Gemini를 사용할 수 있는지 확인하려면 어떻게 해야 하나요?

IDX의 Gemini는 일부 지역에서만 사용할 수 있으며, 사용 가능 여부는 정기적으로 확대되고 있습니다. 거주 지역에서 IDX의 Gemini를 사용할 수 있는 경우 작업공간에 Gemini 추가에 설명된 단계에 따라 이를 사용할 수 있습니다.

Project IDX에서 특정 기능을 사용하고 있었는데 더 이상 찾을 수 없습니다. 콘텐츠가 삭제된 이유는 무엇인가요?

Project IDX의 일부 기능은 실험용입니다. Google은 사용자의 의견을 소중하게 생각하며 이를 바탕으로 현재 및 계획된 기능 세트를 알리고 사용자 또는 Google의 기대에 미치지 못하는 기능은 주기적으로 삭제합니다. 이상적인 버전의 Project IDX에 추가하고 싶은 기능이 있다면 의견을 보내주세요. 의견은 언제나 환영합니다.