A veces, los Servicios de Google Play incluyen bibliotecas de código abierto o dependen de ellas. Para cumplir con los requisitos de licencia de las bibliotecas de código abierto, tú, como desarrollador, eres responsable de mostrar adecuadamente los avisos para las bibliotecas de código abierto que usa tu app.
Los Servicios de Google Play incluyen un conjunto de herramientas diseñadas para brindarles a los desarrolladores una forma más fácil de expresar los avisos de software de código abierto de las bibliotecas que se usan en sus apps. Una de esas herramientas es un complemento de Gradle que recopila términos de licencia de las bibliotecas incluidas, como se declara en sus archivos POM, y crea una actividad que se puede usar para mostrar estos términos. Obtén más información sobre cómo la herramienta encuentra y empaqueta la información de licencia.
Cómo agregar el complemento de Gradle
En tu archivo de compilación de nivel de raíz, haz lo siguiente:
- Incluye el repositorio de Maven de Google.
- Agrega el complemento
oss-licenses
a tus dependencias.
En el siguiente fragmento de código, se muestran estos pasos:
DSL de Kotlin
buildscript { repositories { ... google() // maven { url("https://maven.google.com") } for Gradle <= 3 } dependencies { ... classpath("com.google.android.gms:oss-licenses-plugin:0.10.6") } }
DSL genial
buildscript { repositories { ... google() // maven { url "https://maven.google.com" } for Gradle <= 3 } dependencies { ... classpath 'com.google.android.gms:oss-licenses-plugin:0.10.6' } }
En el archivo de compilación a nivel de la app, aplica el complemento. Para ello, agrega la siguiente línea en la declaración existente del complemento com.android.application
en la parte superior del archivo:
DSL de Kotlin
plugins { id("com.android.application") id("com.google.android.gms.oss-licenses-plugin") }
DSL genial
plugins { id 'com.android.application' id 'com.google.android.gms.oss-licenses-plugin' }
Puedes ver el código de este complemento en GitHub.
Agrega la biblioteca a tu app
En la sección dependencies
de tu archivo de compilación de nivel de app, agrega una dependencia en la biblioteca oss-licenses
:
DSL de Kotlin
implementation("com.google.android.gms:play-services-oss-licenses:17.0.1")
DSL genial
implementation 'com.google.android.gms:play-services-oss-licenses:17.0.1'
Muestra la información de la licencia
Cuando se compila tu app, el complemento de Gradle procesa las licencias y las agrega a los recursos de la app. Para mostrar fácilmente la licencia, puedes iniciar una actividad proporcionada por la biblioteca play-services-oss-licenses
en un punto apropiado de tu app, como se muestra en el siguiente fragmento de código:
Kotlin
import com.google.android.gms.oss.licenses.OssLicensesMenuActivity ... // When the user selects an option to see the licenses: startActivity(Intent(this, OssLicensesMenuActivity::class.java))
Java
import com.google.android.gms.oss.licenses.OssLicensesMenuActivity; ... // When the user selects an option to see the licenses: startActivity(new Intent(this, OssLicensesMenuActivity.class));
Cuando se inicia esta actividad, se muestra una lista de bibliotecas de código abierto que se compilaron en tu app, incluidas las que forman parte de los Servicios de Google Play, como se muestra en la Figura 1. Los usuarios pueden presionar el nombre de una biblioteca para ver información adicional sobre la licencia de esa biblioteca.
Figura 1. En la actividad del menú de licencias, se muestra una lista seleccionable de bibliotecas de código abierto que usa una app.
Cómo establecer el título de la actividad
De forma predeterminada, la actividad que se muestra tiene el título "Licencias de código abierto". Puedes llamar a setActivityTitle()
para personalizar el título de la actividad, como se muestra en el siguiente fragmento de código:
Kotlin
OssLicensesMenuActivity.setActivityTitle(getString(R.string.custom_license_title))
Java
OssLicensesMenuActivity.setActivityTitle(getString(R.string.custom_license_title));
Cómo aplicar un tema a la actividad
Puedes aplicar un tema a la actividad para que coincida con el que se usa en las demás actividades de tu app. Para ello, incluye la actividad de licencia de código abierto en un elemento <activity>
dentro del archivo de manifiesto de tu app, como se muestra en el siguiente fragmento de código:
<application android:theme="@style/AppTheme" ...> <activity android:name="com.google.android.gms.oss.licenses.OssLicensesMenuActivity" android:theme="@style/AppTheme" /> <activity android:name="com.google.android.gms.oss.licenses.OssLicensesActivity" android:theme="@style/AppTheme" /> </application>
Cómo se determina la lista de licencias
En el tiempo de compilación, el complemento de Gradle analiza las dependencias de POM del proyecto de tu app. Cuando existe un POM de Maven para una dependencia directa de la app, el complemento procesa cada elemento <licenses>
e incorpora el vínculo y el título de cada licencia en un recurso de Android que se incluye con tu app.