Instalacao e Configuracao Inicial

Requisitos do Sistema

• macOS 13.0 ou superior
• Intel ou Apple Silicon (ambas as arquiteturas sao suportadas)
• 3 MB de espaco em disco
• Conexao com a internet (para consultas com IA e atualizacoes; alguns recursos funcionam offline)

Metodos de Instalacao

Metodo 1: Baixar o DMG pelo site (Recomendado)

1. Acesse o site oficial do DevGlish
2. Clique no botao Download para baixar o DevGlish.dmg mais recente
3. Clique duas vezes no arquivo .dmg para abrir o instalador
4. Arraste o aplicativo DevGlish para a pasta Applications
5. Pronto! Voce pode encontrar o DevGlish na pasta Applications e inicia-lo

Metodo 2: Versao Beta via TestFlight

Quer experimentar os recursos mais recentes? Participe do programa de testes do TestFlight:

1. Receba o link de convite por e-mail (ou solicite no site do DevGlish)
2. Clique no link e toque em Accept no aplicativo TestFlight
3. O TestFlight baixara automaticamente a versao de teste do DevGlish
4. Apos a instalacao, voce pode iniciar o DevGlish pelo aplicativo TestFlight

Dica

Usar a versao TestFlight permite experimentar novos recursos antes do lancamento oficial. Seu feedback e muito bem-vindo!

Configuracao Essencial: Conceder Permissao de Acessibilidade

O DevGlish usa a API de Acessibilidade do macOS (AXUIElement) para ler o texto que voce seleciona. Essa e uma condicao obrigatoria para o funcionamento do aplicativo.

Por que essa permissao e necessaria?

O DevGlish precisa acessar o texto selecionado em qualquer aplicativo. Seja selecionando trechos de codigo no Xcode, mensagens no Slack ou conteudo em paginas web no navegador, o DevGlish usa essa permissao para capturar o conteudo selecionado e entao realizar a consulta com IA.

Passo 1: Abrir Ajustes do Sistema

1. Clique no logotipo da Apple no canto superior esquerdo da barra de menus
2. Selecione System Settings (Ajustes do Sistema)

Passo 2: Navegar ate Privacidade e Seguranca

1. Na barra lateral esquerda, encontre Privacy & Security (Privacidade e Seguranca)
2. Clique para entrar

Passo 3: Encontrar e Ativar Acessibilidade

1. Role para baixo e encontre a opcao Accessibility (Acessibilidade)
2. Clique em Accessibility
3. Na janela da direita, procure o aplicativo DevGlish
4. Se o DevGlish ainda nao estiver na lista, clique no botao + e selecione o DevGlish na pasta Applications
5. Certifique-se de que o interruptor ao lado do DevGlish esteja ligado (verde)

Cuidado

Se o DevGlish nao tiver permissao de acessibilidade, o atalho global ⌘⇧D nao funcionara.

Passo 4: Iniciar o DevGlish

1. Feche os Ajustes do Sistema
2. Inicie o DevGlish pela pasta Applications ou use a busca Spotlight (⌘Space, digite “DevGlish”)
3. O DevGlish aparecera no canto superior direito da barra de menus (icone de engrenagem)

Login

Apos iniciar o DevGlish, voce precisa fazer login para sincronizar seu progresso de aprendizado e palavras salvas.

Opcao 1: Usar Apple Sign In (Recomendado)

1. Clique no icone do DevGlish na barra de menus
2. Selecione Sign in with Apple
3. Complete o login usando seu Apple ID
4. Autorize o DevGlish a acessar sua conta Apple (usado apenas para autenticacao; o DevGlish nao armazena sua senha)

Opcao 2: Usar Magic Link (Login por e-mail)

1. Clique no icone do DevGlish na barra de menus
2. Selecione Sign in with Email
3. Digite seu endereco de e-mail
4. Verifique seu e-mail e clique no magic link recebido
5. O link fara login automatico no DevGlish

Solucao de Problemas

Problema: Pressionar ⌘⇧D nao faz nada

Solucao:

1. Confirme que o DevGlish esta em execucao (deve haver um icone no canto superior direito da barra de menus)
2. Confirme que o DevGlish esta habilitado em System Settings > Privacy & Security > Accessibility
3. Tente reiniciar o DevGlish: clique no icone da barra de menus → Quit DevGlish, depois reinicie
4. Nas configuracoes de Accessibility, desative e reative o interruptor de permissao do DevGlish

Problema: Nao consigo fazer login ou nao recebo o e-mail

Solucao:

1. Verifique a conexao com a internet
2. Se estiver usando login por e-mail, verifique a pasta de spam (e-mails de Magic Link as vezes sao filtrados)
3. Tente usar Apple Sign In como alternativa
4. Se o problema persistir, entre em contato com [email protected]

Problema: O DevGlish nao consegue acessar o texto selecionado

Solucao:

1. Confirme que voce concedeu a permissao em Accessibility (veja o Passo 3 acima)
2. Alguns aplicativos (como certos apps de seguranca) podem bloquear o acesso de acessibilidade. Tente testar em outros aplicativos (como Notes, TextEdit)
3. Reinicie o DevGlish (clique no icone da barra de menus → Quit, depois reinicie)

Nota

Se o problema nao for resolvido, entre em contato conosco pela nossa pagina de suporte.

Proximo Passo

Agora voce ja instalou e configurou o DevGlish! Va para Primeiros Passos em 3 Minutos para aprender a fazer sua primeira consulta.