AgoraDesk will be winding down

The winding down process begins May 7th, 2024, and finishes after November 7th, 2024. Our support staff will be available for help throughout this period.
  1. Effective immediately, all new signups and ad postings are disabled;
  2. On May 14th, 2024, new trades will be disabled as well;
  3. After November 7th, 2024, the website will be taken down. Please reclaim any funds from your arbitration bond wallet prior to that date, otherwise the funds may be considered abandoned/forfeited.

Comment publier votre application Flutter avec des variantes sur F-Droid ?

F-Droid est un catalogue installable d'applications FOSS (Free and Open Source Software, soit des Logiciels Libres et Open Source) pour la plateforme Android. Le client facilite la navigation, l'installation et le suivi des mises à jour sur votre appareil. Site web de F-Droid

Toutes les étapes de ce didacticiel fonctionneront également pour une application sans variantes.


Quelles applications peuvent être incluses dans F-Droid ?

L'application ne peut être incluse dans F-Droid que si elle est entièrement Open Source - y compris toutes les bibliothèques et dépendances utilisées. En savoir plus sur la politique d'inclusion ici.

Par exemple, si vous utilisez la base de données ObjectBox dans votre application, elle ne peut pas être incluse dans F-Droid (discussion).


Étape 1

  • Créez un fork du dépôt fdroiddata sur Gitlab.
  • Clonez le dépôt sur votre machine.
  • Créez une branche avec l'identifiant de « bundle » de l'application, par exemple co.localmonero.app

Étape 2

Vérifiez que fdroid fonctionne correctement. Exécutez les commandes suivantes dans votre dossier fdroid :

fdroid init
fdroid readmeta

Étape 3

Ajoutez votre projet :

fdroid import --url https://github.com/YOUR_REPO --subdir app

Cela créera un fichier dans le répertoire des métadonnées, par exemple metadata/co.localmonero.app.yml. Vous pouvez également créer ce fichier manuellement.


Étape 4

Ouvrez le fichier et modifiez-le. Voici un exemple : https://gitlab.com/fdroid/fdroiddata/-/blob/master/metadata/co.localmonero.app.yml.

Dans l'exemple, vous pouvez voir :

  1. Flutter est utilisé comme sous-module - c'est une exigence de l'équipe F-Droid.
  2. Pour chaque variante, nous avons utilisé une branche distincte (commande AutoUpdateMode : Version %v-fdroid-lm). C'est parce que Fastlane ne prend pas en charge les variantes avec Flutter.
  3. La première fois nous ajoutons des informations de construction manuellement, à l'avenir, elles seront ajoutées automatiquement par un bot, après avoir poussé un nouveau « tag » (un marquage de version).

Vérifiez que la syntaxe du fichier est correcte : fdroid readmeta.


Étape 5

Maintenant, ajoutons des données pour le catalogue F-Droid. Pour cela, nous créons une branche distincte pour chaque variante :

Après cela, nous créons un dossier pour Fastlane : https://github.com/AgoraDesk-LocalMonero/agoradesk-app-foss/tree/fdroid_ad/fastlane/metadata/android/en-US.

Ajoutez les données requises et envoyez les (via un « push »).


Étape 6

Il est temps d'ajouter l'application à F-Droid.

  1. Créez un « tag » dans le dépôt de votre application.
  2. Envoyez (« push ») les modifications vers le dépôt F-Droid sur Gitlab.
  3. Faites une demande de fusion (« merge request ») dans le dépôt Gitlab. Utilisez l'identifiant de votre application dans le titre.
  4. Attendez l'avis de l'équipe F-Droid.

Conclusion

Le processus est un peu compliqué et différents problèmes peuvent survenir en cours de route. Mais une fois que vous avez configuré le CI (l'intégration continue, qui automatiquement l'application et joue les tests), les mises à jour suivantes seront gérées automatiquement.

Si vous avez des questions, n'hésitez pas à les poser sur notre GitHub.