Índice

Objetivo

O fluxo de termos de uso integrado no SDK serve para facilitar a aceitação dos termos de uso de aplicativos na plataforma fluig, provendo não só um meio de mostrar os termos de uso como também de interromper acesso a outros conteúdos. O acesso só é liberado uma vez que os termos forem aceitos pelo usuário.

Integração

Para integrar o login no seu aplicativo, siga os seguintes passos:

1. Certifique-se que o módulo bllCore do SDK foi adicionado como dependência no seu build.gradle.

2. Adicione no AndroidManifest do seu aplicativo, as seguintes activities.

   AndroidManifest.xml Expandir origem

   <?xml version="1.0" encoding="utf-8"?>
   <manifest
       xmlns:android="http://schemas.android.com/apk/res/android"
       package="com.myapp.package">
    
       <application
           android:name=".Application"
           ... >
           ...
           <activity
               android:name="sdk.fluig.com.bll.core.eula.accept.view.EulaAcceptActivity"
               android:theme="@style/FluigEulaTheme.Light"
               android:screenOrientation="portrait" />
           <activity
               android:name="sdk.fluig.com.bll.core.eula.terms.view.EulaTermsActivity"
               android:theme="@style/FluigEulaTheme.Light" />
       </application>
   </manifest>

3. Altere o fluxo do aplicativo para os termos de uso. Para isso, chame o método start da classe EulaFlow. Para instanciar EulaFlow, é necessário para um Context como primeiro parâmetro. O segundo parâmetro é opcional e indicará o nome da aplicação para o qual os termos de uso se refere. O método start não possui parâmetros. Ao terminar o fluxo, será enviado um Broadcast informando se o usuário aceitou ou não os Termos de Uso.

   MyActivity.java Expandir origem

   import sdk.fluig.com.bll.core.utils.TermsUtils;
    
   public class MyActivity extends Activity {
    
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           ...
   
           //não esqueça de registrar um receptor para o broadcast enviado pelo fluxo
           IntentFilter intentFilter = new IntentFilter();
           intentFilter.addAction(EulaFlow.ACTION_DID_ACCEPT);
           intentFilter.addAction(EulaFlow.ACTION_DID_NOT_ACCEPT);
           registerReceiver(getEulaReceiver(), intentFilter);
   
           //Para chamar o fluxo sem alterações.
           //Por padrão, o SDK irá pegar o nome de seu aplicativo no texto de aviso.
           new EulaFlow(MyActivity.this).start();
           
           //Caso não deseje o nome do seu aplicativo no texto de aviso, passe outro parâmetro no construtor.
           //No caso abaixo, a tela principal irá avisar:
           //"Antes de começar a usar o Meu Aplicativo, nós precisamos que você aceite os Termos de Uso."
           new EulaFlow(MyActivity.this, "Meu Aplicativo").start();
       }
   
       private BroadcastReceiver getEulaReceiver() {
           return new BroadcastReceiver() {
               @Override
               public void onReceive(Context context, Intent intent) {
                   //Neste ponto, fica a critério do usuário decidir como continuar o fluxo de seu aplicativo.
                   //Pegue a action da Intent para checar se os termos foram aceitos ou não.
                   ...
               }
           };
       }
   }

Personalizações

Existem elementos no layout dos termos de uso que podem ser personalizados. Esta seção expõe que elementos são esses e como alterá-los para aderir às suas preferências.

• Tema
• Nome da aplicação
• Cor(es) de fundo
• Logo da empresa
• Conteúdo dos termos de uso

Tema

Na seção Integração, é possível notar que todas as activities do login compartilham do mesmo tema FluigEulaTheme. Este tema possui duas variações: Light e Dark. A diferença entre essas variações é a cor usada nos textos.

• Light deve ser usado nas telas com fundo claro e, portanto, utiliza textos escuros.
• Dark deve ser usado nas telas com fundo escuro e, portanto, utiliza textos claros. 

Nome da aplicação

No exemplo fornecido no passo 3 da seção Integração, é possível notar que existe um segundo parâmetro opcional do EulaFlow. Este parâmetro é nome da aplicação ao qual o fluxo de Termos de Uso se referenciará.

//Neste caso, a tela principal terá o seguinte texto:
//"Antes de começar a usar o Nome da aplicação, nós precisamos que você aceite os Termos de Uso."
new EulaFlow(myContext, "Nome da aplicação").start();

Cor(es) de fundo

O fundo das telas dos termos de uso foi feito com o componente FluigSdkMediaView. Entretanto, neste fluxo só é permitido alterar a(s) cor(es). Para isso, adicione no arquivo values/colors.xml um atributo com o nome eula_backgroundColor e eula_backgroundColor_end. Caso o atributo eula_backgroundColor_end seja definido, será produzido um gradiente horizontal de duas cores.

Logo da empresa

No topo da tela principal do fluxo há o logo da empresa. Por padrão, o logo mostrado é do fluig. Para alterar o logo, adicione uma imagem, no diretório drawable do seu aplicativo, com o nome eula_logo.

Conteúdo dos termos de uso

A tela que exibe os Termos de Uso propriamente dito carrega seu conteúdo de duas maneiras:

• Por meio de uma URL fornecida no arquivo strings.xml no diretório values. O atributo com a URL deve ser nomeado eula_url.
• Por meio de um arquivo HTML localizado em um diretório chamado html dentro no diretório assets. Este arquivo deve ser nomeado eula.