# Instalação

::: info Notícias
🍎 **A extensão nativa do Safari já está disponível!** É totalmente gratuita e suporta a instalação com um clique.
:::

Escolha o seu caminho.

> ⚠️ Nota: O Gestor de Prompts é a única funcionalidade que suporta Gemini™ para Enterprise.

## 1. Lojas de Extensões (Recomendado)

A forma mais simples de começar. As atualizações são automáticas.

**Chrome / Edge / Brave / Opera / Vivaldi:**

[<img src="https://img.shields.io/badge/Chrome_Web_Store-Download-4285F4?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Instalar da Chrome Web Store" height="40"/>](https://chromewebstore.google.com/detail/iifacdnjakkhjjiengaffnegbndgingi?utm_source=github&utm_medium=docs&utm_campaign=organic_growth&utm_content=pt)

**Microsoft Edge:**

[<img src="https://img.shields.io/badge/Microsoft_Edge-Download-0078D7?style=for-the-badge&logo=microsoft-edge&logoColor=white" alt="Instalar do Microsoft Edge Add-ons" height="40"/>](https://microsoftedge.microsoft.com/addons/detail/voyager/gibmkggjijalcjinbdhcpklodjkhhlne)

> **Usuários do Edge:** o Voyager continuará mantendo e publicando a versão do [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/voyager/gibmkggjijalcjinbdhcpklodjkhhlne) para quem precisa do Edge em celulares ou tablets. Se a revisão atrasar, a Chrome Web Store e os pacotes manuais do GitHub continuam disponíveis.

**Firefox:**

[<img src="https://img.shields.io/badge/Firefox_Add--ons-Download-FF7139?style=for-the-badge&logo=firefox&logoColor=white" alt="Instalar do Firefox Add-ons" height="40"/>](https://addons.mozilla.org/firefox/addon/gemini-voyager/)

> 📱 **Android** (Firefox para Android, Edge e outros): todos os plugins também funcionam no celular. A sincronização com o Google Drive não está disponível no Firefox para Android, que não consegue entrar na conta Google.

## 2. A Via Manual (Funcionalidades Mais Recentes)

O processo de revisão da Web Store pode ser lento. Se quiser a versão de ponta imediatamente, instale manualmente.

**Para Chrome / Edge / Brave / Opera:**

1. Descarregue o último `voyager-chrome-vX.Y.Z.zip` das [Releases do GitHub](https://github.com/voyager-crew/voyager/releases).
2. Descompacte o ficheiro.
3. Abra a página de Extensões do seu navegador (`chrome://extensions`).
4. Ative o **Modo de programador** (canto superior direito).
5. Clique em **Carregar expandida** e selecione a pasta que acabou de descompactar.

**Para Firefox:**

1. Descarregue o último `voyager-firefox-vX.Y.Z.xpi` das [Releases](https://github.com/voyager-crew/voyager/releases).
2. Abra o Gestor de Add-ons (`about:addons`).
3. Arraste e largue o ficheiro `.xpi` para instalar (ou clique no ícone de engrenagem ⚙️ -> **Instalar Add-on de Ficheiro**).

> 💡 O ficheiro XPI é oficialmente assinado pela Mozilla e pode ser instalado permanentemente em todas as versões do Firefox.

## 3. Safari (macOS)

O Safari agora suporta distribuição direta! Descarregue a aplicação pré-assinada:

::: warning Atualizando a partir do `Gemini Voyager.app`
O app que contém a extensão agora se chama `Voyager.app`. Como o macOS não substitui apps com nomes de arquivo diferentes, não deixe as duas cópias instaladas.

1. Na extensão antiga, abra as abas do Gemini e do AI Studio que você usa e execute **Sincronização na Nuvem > Enviar para nuvem**. Se você usa destaques sincronizados, ative a sincronização de destaques antes de enviar.
2. Exporte a biblioteca de prompts como arquivo JSON local, como cópia de segurança independente.
3. Feche o Safari e o app que contém a extensão.
4. Mova `/Applications/Gemini Voyager.app` para a Lixeira. Não clique no botão **Desinstalar** do Safari e não limpe os dados de extensões, os dados de sites nem os containers do Safari.
5. Copie `Voyager.app` para `/Applications`, abra-o uma vez e depois ative o Voyager no Safari, se for solicitado.
6. Verifique suas pastas, prompts, configurações e itens com estrela. Se algo estiver faltando, use **Mesclar** ou importe o JSON dos prompts.

O Voyager mantém os identificadores de bundle do app e da extensão existentes, então o macOS e o Safari continuam reconhecendo a mesma identidade do produto. As etapas de backup são uma precaução para instalações manuais antigas.
:::

1. Descarregue a <SafariDownloadLink>última versão do Safari (.dmg)</SafariDownloadLink>.
2. Abra o ficheiro e siga as instruções para instalar.
3. Clique duas vezes para iniciar a aplicação.
4. Ative a extensão nas **Definições do Safari > Extensões**.

> 💡 A versão do Safari está agora diretamente assinada para distribuição — não é necessária conversão com Xcode!
>
> ✅ **Suporte oficial ao Safari**: desde a v1.6.0, há suporte para remoção de marca d'água, exportação de imagens, sincronização com Google Drive/iCloud, notificações de resposta e atualizações pelo Sparkle.

---

_Configuração de desenvolvimento? Se é um programador à procura de contribuir, consulte o nosso [Guia de Contribuição](https://github.com/voyager-crew/voyager/blob/main/.github/CONTRIBUTING.md)._