Além de permitir que seu app venda produtos e assinaturas digitais na Play Store, o Google Play Faturamento oferece ferramentas para gerenciar seu catálogo, preços e assinaturas, relatórios úteis e um fluxo de finalização de compra com a Play Store que já é familiar para seus usuários. Ele também é um requisito para apps publicados na Play Store que vendem produtos e softwares digitais.
O Chrome 88 está sendo lançado com um teste de origem no Android que permite a integração de atividades da Web confiáveis com a API Payment Request e a API Digital Goods para implementar fluxos de compra pelo Google Play Faturamento. Esperamos que esse teste de origem também esteja disponível para o ChromeOS na versão 89.
Para facilitar a integração com o app Android, a equipe de atividades confiáveis na Web está lançando uma biblioteca de extensões para android-browser-helper. Este guia mostra as mudanças necessárias para integrar essa biblioteca a um aplicativo.
Observação:este artigo aborda a integração do app Android. Se você estiver usando o Bubblewrap para criar seu aplicativo, poderá usar a ferramenta para atualizar o app. A implementação no Bubblewrap está sendo rastreada neste problema. Este guia é destinado a quem não usa o Bubblewrap para atualizar o app.
build.gradle
A biblioteca de extensão de faturamento depende da versão 2.1.0 do android-browser-helper. Confira
se o aplicativo está usando uma versão igual ou mais recente.
Você também precisa adicionar uma declaração de implementação para a biblioteca de extensão de faturamento:
dependencies {
...
implementation 'com.google.androidbrowserhelper:androidbrowserhelper:2.1.0'
implementation 'com.google.androidbrowserhelper:billing:1.0.0-alpha05'
}
DelegationService.java
O android-browser-helper é enviado com um DelegationService padrão que pode ser usado diretamente pelos apps.
Ao usar a extensão de faturamento, você precisa de uma versão um pouco personalizada do
DelegationService.
Para fazer isso, você precisa criar sua própria classe DelegationService que estenda a
original e substitua onCreate(). Dentro de onCreate(), você precisa adicionar uma única
chamada de método que registre o aplicativo como um gerenciador da API Digital Goods:
package com.example.yourapp;
import com.google.androidbrowserhelper.playbilling.digitalgoods.DigitalGoodsRequestHandler;
import com.google.androidbrowserhelper.trusted.DelegationService;
public class DelegationService
extends com.google.androidbrowserhelper.trusted.DelegationService {
@Override
public void onCreate() {
super.onCreate();
registerExtraCommandHandler(new DigitalGoodsRequestHandler(getApplicationContext()));
}
}
AndroidManifest.xml
No manifesto do Android, você vai precisar mudar a referência para a biblioteca de delegação da sua própria
implementação. Na declaração service correspondente, substitua
com.google.androidbrowserhelper.trusted.DelegationService pela classe recém-criada.
<service
android:name=".DelegationService"
android:exported="true">
<intent-filter>
<action android:name="android.support.customtabs.trusted.TRUSTED_WEB_ACTIVITY_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</service>
A biblioteca de faturamento também apresenta dois novos componentes que precisam ser adicionados ao manifesto do Android: um serviço ao qual o navegador pode se conectar e verificar se o aplicativo oferece suporte ao pagamento e uma atividade que processa o fluxo de pagamento:
<activity
android:name="com.google.androidbrowserhelper.playbilling.provider.PaymentActivity"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="keyboardHidden|keyboard|orientation|screenLayout|screenSize"
android:exported="true">
<intent-filter>
<action android:name="org.chromium.intent.action.PAY" />
</intent-filter>
<meta-data
android:name="org.chromium.default_payment_method_name"
android:value="https://play.google.com/billing" />
</activity>
<!-- This service checks who calls it at runtime. -->
<service
android:name="com.google.androidbrowserhelper.playbilling.provider.PaymentService"
android:exported="true" >
<intent-filter>
<action android:name="org.chromium.intent.action.IS_READY_TO_PAY" />
</intent-filter>
</service>
Saiba mais sobre a API Digital Goods e o Google Play Faturamento
Este artigo abordou as etapas necessárias especificamente no aplicativo Android que usa a atividade da Web confiável, mas a API Google Play Faturamento tem sua própria terminologia e inclui componentes de cliente e back-end. Recomendamos que você leia a documentação do Google Play Faturamento e da API Digital Goods e entenda os conceitos antes de integrar a API a um aplicativo em produção.