Tutto su descrizioni, grafica e screenshot

Ogni app può avere tutti i contenuti dell’app store, incluse descrizioni tradotte, elementi grafici e schermate (dalla v0.103 dell’app F-Droid e dalla v0.8 di fdroidserver). Ciò è possibile sia quando le app vengono aggiunte via build metadata sia quando vengono inclusi file pre-compilati in un semplice repository. Ci sono tre percorsi per includere i contenuti dell’app store (in ordine di preferenza):

Non rimuovere questa linea (non verrà visualizzata)

Esistono due formati di dati:

  • materiali descrittivi in testo normale o HTML
  • grafica e screenshot come file PNG o JPEG

Un dettaglio importante: i metadati pericolosi e non necessari vengono rimossi dai file di immagine prima che vengano inclusi nel repository. Ad esempio, le informazioni JPEG EXIF hanno problemi di sicurezza e non sono necessarie per visualizzare le immagini. Questo può anche significare che le immagini saranno ricompresse.

Nella repository sorgente dell’app

Esistono due opzioni per includere i materiali dell’app store nel repository sorgente di un’app: fastlane supply e Triple-T Gradle Play Publisher. Entrambi sono strumenti software gratuiti che si integrano nel flusso di lavoro di uno sviluppatore Android. Una volta che i file sono inclusi nel repository sorgente dell’app, e che tali file vengono inclusi in una versione tagged dell’applicazione, F-Droid includerà tutti questi file.

Alla fine, in realtà non è necessario installare o utilizzare fastlane supplyGradle Play Publisher. F-Droid include questi file basati esclusivamente sul layout di file standard utilizzato da tali strumenti.

Tutte le descrizioni e le grafiche localizzate verranno automaticamente visualizzate nella repository F-Droid una volta disponibili nella repository di origine di una release che la repository costruisce. Ad esempio, se questi file sono inclusi in una master branch di git ma non ancora in una versione con tag, non saranno inclusi.

The last important detail is that the texts in the app’s metadata file will override all other descriptive texts from Fastlane/Triple-T. That is specifically Name, Summary, and Description. Once an app’s descriptive texts have been moved into the source repo, then file a merge request or issue to remove Summary and Description from the app’s metadata file.

Here’s the general rule of filling the index from the metadata sources:

metadata file --> fdroiddata localized files --> fastlane/triple-t in app source

For things that can also be scraped from the APK, then we get:

metadata file --> fdroiddata localized files --> fastlane/triple-t in app source --> APK

Nei metadati di build dell’app in una raccolta fdroiddata

All the app store materials can also be added to any fdroiddata repository of build metadata. This follows a file layout modeled after fastlane supply, modified to fit into the fdroiddata workflow. Any files in this layout will be copied into the repo and added to the repo’s index file by fdroid update.

- <fdroiddata>/
  └── metadata/
      └── <package-id>/
          └── <locale>/
              ├── full_description.txt
              ├── short_description.txt
              ├── title.txt
              ├── video.txt
              ├── changelogs/
              │   ├── <version-code>.txt
              │   └── <version-code>.txt
              └── images/
                  ├── featureGraphic.png
                  ├── icon.png
                  ├── promoGraphic.png
                  ├── tvBanner.png
                  ├── phoneScreenshots/
                  │   └── *.png
                  ├── sevenInchScreenshots/
                  │   └── *.png
                  ├── tenInchScreenshots/
                  │   └── *.png
                  ├── tvScreenshots/
                  │   └── *.png
                  └── wearScreenshots/
                      └── *.png

The images must be either JPEGs or PNGs.

Esempio:

Direttamente nella repository F-Droid

The ultimate destination for files from the app’s source repo and fdroiddata metadata sub-directories is in the F-Droid repo. The text all gets included into the index file (aka index-v1.json). All of the graphics files can be directly included in the repo. If graphics files are also in the app’s source or fdroiddata, then the files directly in the repo will be overwritten. The text files from the fastlane layout are ignored if they are in the repo.

- fdroid/
  └── repo/
      └── <package-id>/
          └── <locale>/
              ├── featureGraphic.png
              ├── icon.png
              ├── promoGraphic.png
              ├── tvBanner.png
              ├── phoneScreenshots/
              │   └── *.png
              ├── sevenInchScreenshots/
              │   └── *.png
              ├── tenInchScreenshots/
              │   └── *.png
              ├── tvScreenshots/
              │   └── *.png
              └── wearScreenshots/
                  └── *.png

fdroid update adds all the graphics files it finds in the repo to the index. fdroid server update will sync all of the files in the repo to the various locations where the repo is actually hosted.