Todo sobre descripciones, gráficos y capturas de pantalla

Aplicaciones en F-Droid pueden proporcionar contenido para la tienda de aplicaciones para hacer su acerca de página más interesante e informativo.

Esto es compatible con F-Droid versión 0.103 y fdroidserver versión 0.8.

Criterios de la última pestaña

En el cliente F-Droid, desde la versión 1.6, solo las aplicaciones que tienen todo lo siguiente se muestran en las últimas pestañas:

  • Nombre
  • Icon
  • Resumen
  • Descripción
  • Licencia
  • al menos una entrada nueva para liberar una versión
  • al menos un gráfico (captura de pantalla o una gráfica de características)
  • al menos uno de los traducidos con anterioridad

Obtenga más información en la publicación del anuncio.

Formato de datos

Formatos de archivo de imagen

Las imágenes pueden ser proporcionadas en PNG o JPEG formato. Tienen que tener el final png, jpg o jpeg.

Es importante señalar que los metadatos peligrosos e innecesarios se eliminan de los archivos de imagen antes de incluirlos en el repositorio. Por ejemplo, los datos JPEG EXIF tienen problemas de seguridad, y no son necesarios para mostrar las imágenes. Esto también significa que las imágenes pueden ser comprimidas de nuevo.

Descripciones HTML

La descripción detallada de la aplicación puede utilizar etiquetas HTML. Tenga en cuenta que no todas las etiquetas son compatibles con el renderizador.

  • Etiquetas comunes como li, a with href, ul, ol, li, b, u y i son compatibles.
  • Ciertas etiquetas están explícitamente prohibidas, a saber, applet, base, body, ` button, embed, form, head, html, iframe, img, input, link, object, picture, script, source, style, svg y video`.
  • Tenga en cuenta que un salto de línea se convertirá automáticamente en una etiqueta br.
  • No puede hacer uso de JavaScript.

Formas de proporcionar metadatos

La adición de metadatos se puede realizar de las tres maneras siguientes.

En el repositorio de origen de la aplicación

Para el repositorio oficial de F-Droid, se recomienda ** encarecidamente ** agregar metadatos en el repositorio de origen de la aplicación por las siguientes razones:

  • Los metadatos de la aplicación están bajo el control directo de los propietarios del repositorio
  • Los metadatos del repositorio se copian automáticamente en el repositorio de F-Droid (por lo tanto, no se necesitan solicitudes de fusión (merge))

F-Droid admite dos estructuras de archivos distintas. Estos tienen como objetivo ser compatibles con las herramientas de software libre existentes que permiten publicar aplicaciones en Google Play. No es necesario instalar ninguna de estas herramientas, la estructura del archivo se puede crear fácilmente de forma manual.

Tenga en cuenta que los textos del archivo de metadatos de la app anulan todos los demás textos descriptivos proporcionados a través de las estructuras que se explican a continuación. Esto afecta al Nombre, Resumen, y Descripción. Una vez que los campos de metadatos que estaban previamente en el archivo de metadatos se han movido al repositorio de origen de la aplicación, por favor, presente una solicitud de fusión (merge request) o cuestión para eliminar Resumen y Descripción del archivo de metadatos de la app.

Para obtener más información, consulte las reglas de precedencia descritas al final de este archivo.

F-Droid solo usará archivos de metadatos de la última versión. Esto significa que fdroidserver comprobará la última versión que conoce y escaneará el repositorio en el estado de esa versión en busca de archivos de metadatos.

Todos los archivos de metadatos son completamente opcionales, excepto la descripción resumida corta y la descripción completa más larga. Sin embargo, las aplicaciones que no cumplan ciertos criterios no se mostrarán en la pestaña Lo último.

Estructura Fastlane

La primera de las dos estructuras pretende ser compatible con la herramienta fastlane supply.

La estructura básica del archivo es la siguiente. Preste atención a las notas a la derecha. Cuando se crea esta estructura, debe colocarse en la posición correcta como se describe a continuación.

├── en-US (en-US es el idioma de reserva de F-Droid)
│ ├── short_description.txt (descripción corta, máximo 80 caracteres, obligatoria)
│ ├── full_description.txt (descripción completa de la app, obligatoria)
│ ├── title.txt (nombre de la app)
│ ├── video.txt (URL de un vídeo de presentación de la app)
│ ├── images (imágenes)
│ │ ├── icon.png (icono de la app, obligatorio si tu app no incluye ningún icono png)
│ │ ├── featureGraphic.png (banner promocional, se muestra encima del desc de la app en el cliente F-Droid; apaisado)
│ │ ├── tvBanner.png ("icono" para dispositivos de TV, actualmente no se utiliza)
│ │ ├── phoneScreenshots 
│ │     ├── 1.png
│ │     │── 2.png
│ │ │...
│ │ ├── seveninchScreenshots/ (Screenshots de 7 pulgadas)
│ │ ├── tenInchScreenshots/ (puede añadir diferentes capturas de pantalla para diferentes tamaños de pantalla)
│ │ ├── tvScreenshots/
│ │ └── wearScreenshots/
│ └── registros de cambios
│     ├── 100000.txt (debe corresponder a versionCode, literalmente, sin relleno)
│     ├── 100100.txt (si el código de la versión se estableció en 100100)
│     └── 100101.txt (tamaño máximo: 500 caracteres)
└── ru (otros códigos de localización)
    ...                         (los metadatos localizados son siempre preferidos por el cliente)
    └── registros de cambios
        └── 100100.txt

Esta estructura debe colocarse en una de las siguientes ubicaciones de la raíz del repositorio:

  • metadata/
  • fastlane/metadata/android/

Tenga en cuenta que colocar la estructura en cualquier otro lugar, como en la raíz del módulo gradle, no funcionará.

Las versiones de compilación y varias aplicaciones dentro de un repositorio no son compatibles actualmente. (Siga este problema rastreando la implementación de esto).

Estructura Triple-T

La segunda estructura admitida es compatible con la herramienta Triple-T Gradle Play Publisher .

Coloque la siguiente estructura en <module>/src/main/play/ o, para soporte de tipo de construcción, en <module>/src/<buildFlavor>/play/, donde <module> es el módulo Gradle de su aplicación (en muchos casos, esta es solo la carpeta aplicación):

├── contact-email.txt                   (Correo del Desarrollador / Correo del Autor)
├── contact-website.txt                 (Sitio Web del Desarrollador / Sitio Web del Autor)
├── release-notes
│   └── en-US
│       └── default.txt                 (último registro de cambios)
└── listings
    ├── en-US                           (en-US es el lenguaje predeterminado de F-Droid)
    │   ├── title.txt                   (nombre de la aplicación)
    │   ├── short-description.txt       (descripción corta, máximo 80 caracteres, obligatorio)
    │   ├── full-description.txt        (descripción completa de la aplicación, obligatorio)
    │   ├── video-url.txt               (URL al video de introducción de la aplicación)
    │   ├── whatsnew                    (ubicación alterna del registro de cambios; archivo único, no .txt)
    │   └── graphics
    │       ├── icon                    (icono de la aplicación; obligatorio si su aplicación no incluye ningún icono png)
    │       │   └── *.(png|jpg)         1 imagen, generalmente 512x512
    │       ├── feature-graphic         (banner promocional, que se muestra en la parte superior de la descripción de la 
    │       │    │                                              aplicación en el cliente F-Droid)
    │       │   └── *.(png|jpg)         1 imagen, generalmente 1024x500
    │       ├── phone-screenshots
    │       │   └── *.(png|jpg)
    │       ├── tablet-screenshots
    │       │   └── *.(png|jpg)
    │       ├── large-tablet-screenshots
    │       │   └── *.(png|jpg)
    │       ├── tv-banner               ("icono" para dispositivos TV, no utilizado actualmente)
    │       │   └── *.(png|jpg)
    │       ├── tv-screenshots
    │       │   └── *.(png|jpg)
    │       └── wear-screenshots
    │           └── *.(png|jpg)
    ├── de                              (otros locales)
        ├── ...

En los metadatos de compilación de la aplicación en una colección fdroiddata

Nota: Esta opción solo está destinada a quienes alojan sus propios repositorios. Si eres un desarrollador que quiere conseguir una aplicación en el repositorio principal de F-Droid, no elija esta opción. Específicamente, es posible que no se agreguen capturas de pantalla a el repositorio * fdroiddata *.

Los archivos de metadatos también se pueden añadir a cualquier repositorio de metadatos de construcción (build metadata) fdroiddata. La estructura de los archivos está modelada también según fastlane y tiene el mismo aspecto que se muestra arriba, con las siguientes notas adicionales.

  • Coloca la estructura en la siguiente ubicación: <fdroiddata>/metadata/<packageId>/ 3] Por ejemplo, para es-US, title.txt residiría en esta ubicación: <fdroiddata>/metadata/<packageId>/en-US/title.txt
  • En lugar de short_description.txt, el archivo de resumen debería llamarse summary.txt.
  • En lugar de fulll_description.txt, el archivo de descripción debería llamarse description.txt.
  • No seguir los dos puntos anteriores hace que el linter falle.

En el repositorio de F-Droid

Nota: Esta opción sólo está disponible para aquellos que alojan sus propios repositorios.

El destino final de los archivos del repositorio de la app y de los subdirectorios de metadatos fdroiddata está en el repositorio de F-Droid. Todo el texto se incluye en el archivo de índice (también conocido como index-v1.json). Todos los archivos gráficos se pueden incluir directamente en el repo.

Si los archivos gráficos también están en el código fuente de la aplicación o en fdroiddata, entonces se sobrescribirán los archivos directamente en el repositorio.

No puede colocar archivos de texto directamente en el repositorio.

Como referencia, los archivos de imágenes pueden colocarse en el repositorio en las siguientes ubicaciones:

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

Precedencia

Las siguientes reglas generales de precedencia se aplican cuando varias de las opciones anteriores proporcionan metadatos:

  • El archivo de metadatos (es decir, ` /metadata/.yml `) sobrescribe archivos de *fdroiddata*, incluso los localizados.
  • Los archivos fdroiddata sobrescriben los metadatos del codigo fuente de la app.
  • Para los datos que también están contenidos en el archivo APK como el nombre de la app, las dos opciones anteriores sobrescriben los datos del archivo APK.

Sin embargo, también se aplica la siguiente norma más específica:

  • Los archivos gráficos de la fuente de la app de fdroiddata sobrescriben los archivos del repositorio.