Às vezes, o Google Play Services inclui ou depende de bibliotecas de código aberto. Para obedecer aos requisitos de licença das bibliotecas de código aberto, você, como desenvolvedor, é responsável por exibir adequadamente os avisos para as bibliotecas de código aberto usadas pelo seu app.
O Google Play Services inclui um conjunto de ferramentas projetadas para oferecer aos desenvolvedores uma maneira mais fácil de expressar os avisos de software de código aberto das bibliotecas usadas nos apps. Uma dessas ferramentas é um plug-in do Gradle que coleta termos de licença de bibliotecas incluídas, conforme declarado nos arquivos do POM, e cria uma atividade que pode ser usada para exibir esses termos. Saiba mais sobre como a ferramenta encontra e empacota informações de licença.
Adicionar o plug-in do Gradle
No arquivo de build no nível raiz, faça o seguinte:
- Inclua o repositório Maven do Google.
- Adicione o plug-in
oss-licenses
às dependências.
O snippet de código a seguir mostra essas etapas:
DSL do Kotlin
build.gradle.kts
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 estiloso
build.gradle
buildscript { repositories { ... google() // maven { url "https://maven.google.com" } for Gradle <= 3 } dependencies { ... classpath 'com.google.android.gms:oss-licenses-plugin:0.10.6' } }
No arquivo de build no nível do app, aplique o plug-in adicionando a seguinte linha
na declaração atual do plug-in com.android.application
na
parte superior do arquivo:
DSL do Kotlin
app/build.gradle.kts.
plugins { id("com.android.application") id("com.google.android.gms.oss-licenses-plugin") }
DSL estiloso
app/build.gradle
plugins { id 'com.android.application' id 'com.google.android.gms.oss-licenses-plugin' }
Você pode ver o código (link em inglês) desse plug-in no GitHub.
Adicionar a biblioteca ao app
Na seção dependencies
do arquivo de build do app, adicione uma dependência à biblioteca oss-licenses
:
DSL do Kotlin
build.gradle.kts
implementation("com.google.android.gms:play-services-oss-licenses:17.0.1")
DSL estiloso
build.gradle
implementation 'com.google.android.gms:play-services-oss-licenses:17.0.1'
Exibir informações da licença
Quando o app é criado, o plug-in para Gradle processa as licenças e as adiciona aos
recursos do app. Para exibir a licença com facilidade, inicie uma atividade
fornecida pela biblioteca play-services-oss-licenses
em um ponto
apropriado do app, conforme mostrado no snippet de código a seguir.
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));
Quando iniciada, essa atividade exibe uma lista de bibliotecas de código aberto compiladas no app, incluindo as que fazem parte do Google Play Services, como mostrado na Figura 1. Os usuários podem tocar no nome de uma biblioteca para ver mais informações sobre ela.
Figura 1. A atividade do menu de licenças mostra uma lista selecionável de bibliotecas de código aberto que um app usa.
Definir o título da atividade
Por padrão, a atividade exibida tem o título "Licenças de código aberto". Você pode
personalizar o título da atividade chamando
setActivityTitle()
,
conforme mostrado no snippet de código a seguir:
Kotlin
OssLicensesMenuActivity.setActivityTitle(getString(R.string.custom_license_title))
Java
OssLicensesMenuActivity.setActivityTitle(getString(R.string.custom_license_title));
Aplicar um tema à atividade
Você pode aplicar um tema à atividade para corresponder ao tema usado em outras
atividades do app. Para fazer isso, inclua a atividade de licença de código aberto em um elemento <activity>
no arquivo de manifesto do app, conforme mostrado no snippet de código a seguir:
<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>
Como a lista de licenças é determinada
No tempo de compilação, o plug-in do Gradle verifica as dependências do POM do projeto
do app. Quando um POM do Maven existe para uma dependência direta do app, o plug-in
processa cada elemento <licenses>
e incorpora o link e o título de cada licença em um recurso do Android
incluído no app.