Solução de problemas e perguntas frequentes sobre o IDX do projeto

Ao abrir um espaço de trabalho, vejo a mensagem Não foi possível encaminhar sua solicitação para o back-end. Não foi possível se conectar a um servidor na porta 80.

Esse é um problema conhecido. Como solução alternativa, aguarde aproximadamente cinco segundos e atualize a página.

Minha visualização não funciona, mas não vejo nada de errado com meu código. Como posso reiniciar o IDX?

Se o IDX não estiver sendo atualizado corretamente, normalmente como resultado de grandes refatorações ou mudanças no arquivo monospace.json, execute uma reinicialização forçada, disponível na paleta de comandos (Cmd+Shift+P no Mac ou Ctrl+Shift+P no ChromeOS, Windows ou Linux), na categoria IDX.

Ao criar um espaço de trabalho, aparece a mensagem Ops... Precisamos ativar uma nova VM, e a IU trava depois disso.

O IDX mantém um pool de VMs quentes usado para provisionar espaços de trabalho sob demanda. Quando o pool fica baixo, os espaços de trabalho são provisionados após a ativação de uma nova VM. O processo pode levar algum tempo (às vezes até 5 minutos), mas é bem-sucedido.

Ao criar um espaço de trabalho, vejo uma mensagem: Ocorreu um erro interno

Na maioria dos casos de erros internos durante o provisionamento do espaço de trabalho, atualizar a página após cerca de um minuto leva o erro para o espaço de trabalho.

Quantos espaços de trabalho diferentes posso ter na minha conta?

O IDX tem um limite de um espaço de trabalho por usuário. Se você tiver um Perfil do desenvolvedor do Google, poderá criar até cinco espaços de trabalho. Para criar um Perfil do desenvolvedor do Google diretamente no IDX, depois de atingir o limite do espaço de trabalho, clique em Concluir configuração na notificação no painel de modelos.

Meu espaço de trabalho é carregado, mas o emulador está em branco

Estamos melhorando ativamente a confiabilidade dos nossos emuladores baseados na nuvem. Se uma atualização da página não corrigir o problema, informe o problema.

Os espaços de trabalho IDX têm uma versão do Flutter incompatível com meu projeto.

É possível fazer upgrade ou downgrade da versão de quase todos os softwares pré-instalados em um espaço de trabalho, da mesma forma que você faria na sua máquina local (usando apt-get ou brew). As alterações não são preservadas quando um espaço de trabalho "inativo" hiberna.

Qual é a diferença entre o Project IDX e o Google Cloud Workstations?

Criamos o IDX na (incrível!) oferta do Cloud Workstations do Google Cloud com disponibilidade geral. O Cloud Workstations é uma oferta de infraestrutura que se concentra na confiabilidade, segurança e disponibilidade das estações de trabalho do desenvolvedor. É a escolha ideal para grandes empresas que querem gerenciar a própria experiência de desenvolvimento. O IDX do projeto é um ambiente com "baterias incluídas" dentro dessas estações de trabalho que gerencia os conjuntos de ferramentas, a pilha de desenvolvimento de software e as dependências do sistema necessárias para criar diferentes tipos de aplicativos.

Não sei muito sobre Linux. Como aumentar a produtividade no Project IDX?

O Project IDX expõe um shell do Debian que você pode usar para instalar e gerenciar dependências de software no nível do sistema do seu projeto. Em breve, estamos migrando para um shell baseado em Nix e independente de SO, que pode ser usado para gerenciar dependências de software do sistema como configurações sem entender as especificidades de gerenciadores de pacotes específicos do SO, como o apt. Não perca as novidades!

Por que a IDX precisa de cookies de terceiros ativados?

O IDX precisa de cookies de terceiros ativados porque renderizamos um IFRAME de um domínio (um subdomínio de cloudworkstations.dev) em outro (idx.google.com), e os cookies de terceiros permitem a comunicação segura entre origens.

Só é possível compartilhar um URL do espaço de trabalho com usuários que têm acesso a ele. Usuários sem permissão verão um erro ao tentarem acessar o URL. Compartilhe explicitamente o espaço de trabalho com eles, como um arquivo do Documentos Google.

Os usuários adicionados ao seu espaço de trabalho têm acesso completo a todo o sistema de arquivos da VM, que pode conter arquivos confidenciais, como chaves privadas e tokens de acesso. Compartilhe seu espaço de trabalho apenas com pessoas em quem você confia. Essa abordagem ajuda outros usuários a visualizar o estado exato do espaço de trabalho, mas significa que eles veem tudo nele.

Quando você usa o IDX para implantar seus aplicativos no Firebase, o espaço de trabalho é provisionado com apenas as permissões mais básicas necessárias para executar as operações. Embora você, como usuário, possa ser um administrador do projeto, o espaço de trabalho em si não tem todas as permissões de ser um proprietário, operando com base nos princípios de privilégio mínimo.

Posso usar frameworks que não são compatíveis com o IDX para criar meu aplicativo?

Sim. Enquanto trabalhamos para permitir que os espaços de trabalho sejam totalmente personalizáveis, é totalmente possível importar projetos que usam um framework de front-end sem suporte ou que não têm uma interface. A maneira mais simples de superar isso é selecionar Outro como o Tipo de app no fluxo Importar um repositório. Depois de configurar o espaço de trabalho, é possível instalar todas as dependências no nível do sistema necessárias para o projeto.

Posso importar meu repositório do GitLab ou do Cloud Source Repositories?

No momento, oferecemos suporte ao GitHub. Se você quiser que o Google ofereça suporte a mais hosts Git, envie uma solicitação de recurso.

Enquanto isso, você pode criar um novo espaço de trabalho a partir de um modelo atual e executar git clone com qualquer host Git baseado em https ou ssh em um terminal, como faria normalmente em sua máquina local.

Qual diretório de destino devo selecionar ao implantar um app do Flutter no Firebase Hosting?

Escolha o diretório build/web. Esse diretório precisa conter um index.html e todos os recursos estáticos necessários para renderizar seu app da Web depois que ele for criado (via flutter build web).

Como posso configurar o back-end do app no meu espaço de trabalho para que meu front-end possa se comunicar com ele?

Planejamos simplificar isso em breve, mas, por enquanto, use a seguinte solução alternativa:

Os projetos que têm um back-end de API podem iniciar os serviços da API manualmente em um terminal ou configurar o comando de inicialização no arquivo monospace.json.
Abra a porta em que o serviço da API é executado para ficar acessível à visualização do front-end da Web executando o script bash a seguir em um terminal:
```
export port=4000 #dont use restricted ports (8000, 9000-9002)
export API_SERVICE="https://$port-$WEB_HOST"
echo $API_SERVICE
```
Abra o API_SERVICE URL acima de uma nova guia no navegador. Isso define um cookie obrigatório por meio de um fluxo de redirecionamento.
O front-end do seu app da Web agora pode acessar o serviço da API no caminho totalmente qualificado.

fechei a guia de visualização. Como faço para trazê-lo de volta?

Abra a paleta de comandos (Cmd+Shift+P no Mac ou Ctrl+Shift+P no ChromeOS, Windows ou Linux) e selecione Project IDX: Show Web Preview.

O que é Code OSS?

O software de código aberto (Code-OSS) é um projeto de código aberto que é a camada principal do VS Code. O Code-OSS está disponível no GitHub sob a Licença MIT padrão e é onde a Microsoft desenvolve o produto VS Code.

Como posso evitar que o preenchimento de código e os comandos do chat do Gemini sejam usados como dados de treinamento?

Se você não quiser que as solicitações de chat do Gemini sejam usadas como dados de treinamento para melhorar o Gemini no IDX, não use o assistente de chat e desative o preenchimento de código nas configurações do espaço de trabalho.

Como envio uma solicitação de recurso ou feedback sobre um problema que encontrei?

Se você encontrar um problema ao usar o Project IDX, registre um bug para nos informar.

Se houver um recurso que você queira adicionar ao IDX ou quiser expandir um recurso, envie uma solicitação de recurso.

O IDX usa o IssueTracker para bugs e solicitações de recursos, oferecendo suporte a solicitações robustas com capturas de tela e vídeos. No futuro, o IDX provavelmente rastreará feedback e recursos pelo UserVoice. Qualquer feedback ou solicitação já enviado pelo UserVoice foi preservado e compartilhado com a equipe.

Como posso saber se o Gemini no IDX está disponível no meu país ou região?

Gemini no IDX está disponível em regiões limitadas, e a disponibilidade aumenta regularmente. Se o Gemini no IDX estiver disponível na sua região, adicione-o ao espaço de trabalho seguindo as etapas descritas em Adicionar o Gemini ao seu espaço de trabalho.

Eu estava usando um recurso específico no Project IDX, mas não consigo mais encontrá-lo. Por que ele foi removido?

Alguns dos recursos do Project IDX são experimentais. Valorizamos seu feedback e o usamos ativamente para informar nosso conjunto de recursos atual e planejado, removendo periodicamente recursos que não estão correspondendo às nossas expectativas ou às nossas. Se você quiser ver alguns recursos na sua versão ideal do Project IDX, envie seu feedback. Queremos saber sua opinião.