ProtonVPN per Android

Copyright (c) 2019 Proton AG

Download

Istruzioni di compilazione

• Installare sdk, ndk, cmake, swig
• Clonare questo repository
• ./gradlew assembleProductionVanillaOpenSourceDebug oppure aprire e compilare in Android Studio

Build di release

Per completare una build di release è necessario fornire le chiavi di firma:

• ./gradlew assembleProductionVanillaOpenSourceRelease -PkeyStoreFilePath=<keystore> -PkeyStoreKeyAlias=<alias> -PkeyStorePassword=<pass> -PkeyStoreKeyPassword=<key-pass>

Stile del codice

Il progetto utilizza lo stile di codice concordato ProtonStyle.xml per Java. Importalo in Android Studio tramite File>>Settings>>Editor>>Code style>>Import Scheme Per lo stile di codice Kotlin utilizziamo ktlint con le regole predefinite

Contribuire

Se desideri contribuire, tieni presente le seguenti regole:

• Cerca di attenerti allo stile di codice e alle convenzioni di denominazione esistenti del progetto
• La base di codice è scritta principalmente in Java, ma stiamo passando a Kotlin, quindi il nuovo codice dovrebbe essere scritto in Kotlin dove possibile
• Il nostro stack tecnologico preferito è Kotlin, MVVM, data-binding e coroutine, quindi qualsiasi nuova funzionalità o refactoring di grandi dimensioni dovrebbe conformarsi a questo stack tecnologico
• Dopo aver aggiunto/aggiornato le dipendenze open source esegui gradlew updateLicensesJson per aggiornare le attribuzioni.

Internamente la nostra CI controlla automaticamente tutte le pull request per problemi di stile del codice ed esegue i nostri test. Tuttavia puoi eseguirli anche localmente.

gradlew checkstyle
gradlew detekt
gradlew test
gradlew androidTest

Contribuendo a questo progetto accetti quanto segue:

1. Cedo a Proton AG qualsiasi diritto d'autore relativo al contributo;
2. Certifico che il contributo è stato creato interamente da me;
3. Comprendo e accetto che questo progetto e il contributo sono pubblici e che una registrazione del contributo (incluse tutte le informazioni personali che invio con esso) viene conservata a tempo indeterminato e può essere ridistribuita con questo progetto o con le licenze open source coinvolte.

Firma

Tutte le nostre build (tranne F-droid) saranno firmate con la stessa chiave. Impronta SHA256 del certificato di firma

ch.protonvpn.android
DC:C9:43:9E:C1:A6:C6:A8:D0:20:3F:34:23:EE:42:BC:C8:B9:70:62:8E:53:CB:73:A0:39:3F:39:8D:D5:B8:53

Versionamento

• La versione corrisponde al formato: [major][minor][patch][hotfix]

Licenza

Il codice e i file di dati in questa distribuzione sono concessi in licenza secondo i termini della GPLv3 come pubblicata dalla Free Software Foundation. Consulta https://www.gnu.org/licenses/ per una copia di questa licenza.

Copyright (c) 2019 Proton AG