OONI Probe Desktop

O OONI Probe é um software gratuito e de código aberto projetado para medir a censura na internet e outras formas de interferência de rede.

Clique aqui para relatar um bug

Outras plataformas suportadas: iOS, Desktop, CLI

Esta é a implementação desktop do OONI Probe.

Nossas duas principais plataformas-alvo são:

• macOS
• Windows > 7 (também podemos suportar versões mais antigas, mas não como alvos principais)

Além disso, como é escrito em electron, planejamos também suportar usuários de desktop Linux.

Para alguns antecedentes sobre a decisão de usar electron e as bibliotecas que escolhemos usar, veja: Writing a modern cross-platform desktop app.

Configuração

Para começar a trabalhar nisso, assumimos que você tem node e yarn instalados.

Então você pode executar:

yarn install

Também será necessário ter copiado um binário compilado de probe-cli e tor para o diretório da plataforma na qual pretende fazer o desenvolvimento.

Para verificar os binários do tor descarregados, deve importar a chave PGP dos programadores do tor da seguinte forma (pode ser verificada em: https://support.torproject.org/tbb/how-to-verify-signature/):

gpg --recv-keys EF6E286DDA85EA2A4BA7DE684E2C6E8793298290

Você pode então baixar os assets executando:

yarn run download:probe-cli
yarn run download:tor

Executar o aplicativo em modo de desenvolvimento

Para compilar e executar uma instância do Electron em modo de desenvolvimento, execute:

yarn run start

Atualizar as traduções

• Salve as strings da planilha canônica em data/lang-en.csv
• Execute node scripts/update-translations.js
• Faça commit de data/lang-en.csv, lang/*.json e renderer/static/translations.js no git

Compilar e assinar o aplicativo macOS

Obtenha o certificado de desenvolvimento e a chave privada da nossa equipe (YWCG8FZTLT) com outro desenvolvedor da OONI que tenha acesso a eles. Ele precisa garantir que exporte não apenas o certificado, mas também a chave privada relacionada. Você deverá receber um arquivo .p12 criptografado com senha contendo ambos. Basta clicar duas vezes nesse arquivo e fornecer a senha para importar o certificado e a chave para o seu chaveiro. Nesse momento, descarte o arquivo .p12 usando rm -P.

Crie um arquivo .env no diretório raiz com o seguinte conteúdo:

GH_TOKEN=TOKEN
[email protected]
OONI_APPLEIDPASS=XXXX
OONI_TEAMID=YWCG8FZTLT

onde TOKEN é um token pessoal do github com escopo de repositório, [email protected] é o Apple ID que você está usando como parte da nossa equipe, XXXX é uma senha específica de aplicativo criada ao acessar appleid.apple.com e fazer login como [email protected], e YWCG8FZTLT é o ID da equipe usado pela OONI.

Em seguida, execute:

yarn install
yarn pack:mac

Isso criará ./dist/OONI Probe-$VERSION.dmg.

Compilar e assinar um aplicativo no Windows

Você precisará de uma cópia da chave de assinatura de código para Windows que termine com .p12.

Para gerar uma compilação assinada, você terá que definir as variáveis de ambiente:

WIN_CSC_LINK=/path/to/key.p12
WIN_CSC_KEY_PASSWORD=KEY_PASSWORD

Você poderá então executar:

yarn install
yarn run pack:win

Publicar uma versão

Execute:

yarn install
yarn run publish:mac
yarn run publish:win

Ressalva importante: certifique-se de não enviar a tag para a próxima versão antes que o comando yarn run publish tenha sido executado com sucesso. Se o fizer, os usuários do aplicativo OONI Probe Desktop receberão um erro ao iniciar o aplicativo, pois o sistema de atualização automática tentará buscar os metadados associados a essa tag.