OONI Probe Desktop

OONI Probe es un software libre y de código abierto diseñado para medir la censura en internet y otras formas de interferencia de red.

Haz clic aquí para reportar un error

Otras plataformas compatibles: iOS, Desktop, CLI

Esta es la implementación de escritorio de OONI Probe.

Nuestras dos plataformas objetivo principales son:

• macOS
• Windows > 7 (también podemos admitir versiones anteriores, pero no como objetivos principales)

Además, dado que está escrito en electron, planeamos también dar soporte a los usuarios de escritorio de Linux.

Para conocer algunos antecedentes sobre la decisión de usar electron y las bibliotecas que elegimos utilizar, consulta: Writing a modern cross-platform desktop app.

Configuración

Para empezar a trabajar en esto, asumimos que tienes node y yarn instalados.

Luego puedes ejecutar:

yarn install

También necesitarás haber copiado un binario compilado de probe-cli y tor en el directorio de la plataforma en la que planeas desarrollar.

Para verificar los binarios de tor descargados, debes importar la clave PGP de los desarrolladores de tor de la siguiente manera (se puede verificar desde: https://support.torproject.org/tbb/how-to-verify-signature/):

gpg --recv-keys EF6E286DDA85EA2A4BA7DE684E2C6E8793298290

A continuación, puedes descargar los recursos ejecutando:

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

Ejecutar la aplicación en modo de desarrollo

Para compilar y ejecutar una instancia de Electron en modo de desarrollo, ejecuta:

yarn run start

Actualizar las traducciones

• Guarda las cadenas de la hoja de cálculo canónica en data/lang-en.csv
• Ejecuta node scripts/update-translations.js
• Haz commit de data/lang-en.csv, lang/*.json y renderer/static/translations.js en git

Compilar y firmar la aplicación de macOS

Obtén el certificado de desarrollo y la clave privada de nuestro equipo (YWCG8FZTLT) de otro desarrollador de OONI que tenga acceso a ellos. Deben asegurarse de exportar no solo el certificado sino también la clave privada asociada. Deberías recibir un archivo .p12 cifrado con contraseña que contenga ambos. Simplemente haz doble clic en este archivo y proporciona la contraseña para importar el certificado y la clave en tu llavero. En ese momento, deshazte del archivo .p12 usando rm -P.

Crea un archivo .env en el directorio raíz con el siguiente contenido:

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

donde TOKEN es un token personal de github con alcance de repositorio, [email protected] es el Apple ID que estás usando como parte de nuestro equipo, XXXX es una contraseña de aplicación específica creada visitando appleid.apple.com e iniciando sesión como [email protected], y YWCG8FZTLT es el ID de equipo usado por OONI.

Luego, ejecuta:

yarn install
yarn pack:mac

Esto generará ./dist/OONI Probe-$VERSION.dmg.

Compilar y firmar una aplicación en Windows

Necesitarás una copia de la clave de firma de código para Windows que termine en .p12.

Para generar una compilación firmada tendrás que establecer las variables de entorno:

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

A continuación podrás ejecutar:

yarn install
yarn run pack:win

Publicar una versión

Ejecutar:

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

Advertencia importante: asegúrate de no subir la etiqueta de la próxima versión hasta que el comando yarn run publish se haya ejecutado correctamente. Si lo haces, los usuarios de la aplicación OONI Probe Desktop recibirán un error al iniciarla, ya que el sistema de actualización automática intentará obtener los metadatos asociados a esa etiqueta.