OONI Probe Desktop

OONI Probe è un software gratuito e open source progettato per misurare la censura di internet e altre forme di interferenza di rete.

Clicca qui per segnalare un bug

Altre piattaforme supportate: iOS, Desktop, CLI

Questa è l'implementazione desktop di OONI Probe.

Le nostre due piattaforme principali di destinazione sono:

• macOS
• Windows > 7 (potremmo supportare anche versioni precedenti, ma non come target principali)

Inoltre, poiché è scritto in electron, prevediamo di supportare anche gli utenti desktop Linux.

Per alcune informazioni di contesto sulla decisione di utilizzare electron e sulle librerie che abbiamo scelto di utilizzare, vedi: Writing a modern cross-platform desktop app.

Setup

Per iniziare a lavorare su questo progetto, presupponiamo che tu abbia node e yarn installati.

Poi puoi eseguire:

yarn install

Dovrai anche aver copiato un binario compilato di probe-cli e tor nella directory della piattaforma su cui prevedi di svolgere lo sviluppo.

Per verificare i binari tor scaricati dovresti importare la chiave PGP degli sviluppatori di tor come segue (può essere verificata da: https://support.torproject.org/tbb/how-to-verify-signature/):

gpg --recv-keys EF6E286DDA85EA2A4BA7DE684E2C6E8793298290

Puoi quindi scaricare gli asset eseguendo:

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

Eseguire l'app in modalità sviluppo

Per compilare ed eseguire un'istanza electron in modalità sviluppo, eseguire:

yarn run start

Aggiornare le traduzioni

• Salva le stringhe dal foglio di calcolo canonico in data/lang-en.csv
• Esegui node scripts/update-translations.js
• Esegui il commit di data/lang-en.csv, lang/*.json e renderer/static/translations.js in git

Compilare e firmare l'app macOS

Ottieni il certificato di sviluppo e la chiave privata per il nostro team (YWCG8FZTLT) da un altro sviluppatore OONI che vi ha accesso. Devono assicurarsi di esportare non solo il certificato ma anche la relativa chiave privata. Dovresti ricevere un file .p12 cifrato con password contenente entrambi. Basta fare doppio clic su questo file e fornire la password per importare il certificato e la chiave nel tuo portachiavi. A questo punto, elimina il file .p12 usando rm -P.

Crea un file .env nella directory principale con il seguente contenuto:

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

dove TOKEN è un token personale di github con scope sul repository, [email protected] è l'Apple ID che stai usando come parte del nostro team, XXXX è una password specifica per l'applicazione creata visitando appleid.apple.com e accedendo come [email protected], e YWCG8FZTLT è il team ID usato da OONI.

Poi, esegui:

yarn install
yarn pack:mac

Questo creerà ./dist/OONI Probe-$VERSION.dmg.

Compilare e firmare un'app su Windows

Sarà necessaria una copia della chiave di firma del codice per Windows che termina con .p12.

Per generare una build firmata sarà necessario impostare le variabili d'ambiente:

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

Potrai quindi eseguire:

yarn install
yarn run pack:win

Pubblicare una release

Esegui:

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

Avvertenza importante: assicurati di non effettuare il push del tag per la release imminente prima che il comando yarn run publish sia stato eseguito con successo. Se lo fai, gli utenti dell'app OONI Probe Desktop riceveranno un errore all'avvio dell'app, perché il sistema di aggiornamento automatico tenterà di recuperare i metadati associati a quel tag.