Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

...

Índice

...

outline

...

true

...

exclude.*ndice
stylenone


...

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.

    Bloco de código
    languagexml
    titleAndroidManifest.xml
    collapsetrue
    <?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=".termssdk.fluig.com.bll.core.eula.accept.view.TermsUseAcceptActivityEulaAcceptActivity"
                android:theme="@style/FluigTermsUseThemeFluigEulaTheme.Light"
                android:screenOrientation="portrait" />
            <activity
                android:name="sdk.fluig.com.bll.core.eula.terms.read.view.TermsUseReadActivityEulaTermsActivity"
                android:theme="@style/FluigTermsUseThemeFluigEulaTheme.Light" />
        </application>
    </manifest>
  3. Altere o fluxo do aplicativo para os termos de uso. Para isso, chame o método startFlowstart da classe TermsUtils, passando um  EulaFlow. Para instanciar EulaFlow, é necessário para um Context como primeiro parâmetro. O segundo parâmetro pode ser ou a classe da Activity ou um Intent contendo a Activity que deseja que seja mostrada após o usuário aceitar os termosé 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.

    Bloco de código
    languagejava
    titleMyActivity.java
    collapsetrue
    import sdk.fluig.com.bll.core.utils.TermsUtils;
     
    public class MyActivity extends Activity {
     
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            ...
    
            //Classe da tela após aceitação dos termosnão esqueça de registrar um receptor para o broadcast enviado pelo fluxo
            IntentFilter intentFilter = new IntentFilter();
            intentFilter.addAction(EulaFlow.ACTION_DID_ACCEPT);
            TermsUtils.startFlow(getBaseContext(), MainActivity.classintentFilter.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 possua uma Intent
     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  Intent myIntent = ...a usar o Meu Aplicativo, nós precisamos que você aceite os Termos de Uso."
            new EulaFlow(MyActivity.this, "Meu Aplicativo").start();
        }
    
         TermsUtils.startFlow(getBaseContext(), myIntent);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.
                    ...
                }
            finish()};
        }
    }

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

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á.

Bloco de código
languagejava
titleExample.java
collapsetrue
//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.

Nota
titleImportante

A Toolbar de cada tela segue o mesmo padrão de cor(es) definido(s) acima.


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.

Aviso
titleImportante

A imagem adicionada deve ter no máximo 195px (em mdpi) de altura e a largura deve obedecer o espaçamento dos aparelhos.


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.

Nota
titleImportante

Caso ambos meios sejam fornecidos ao SDK, a URL no arquivo strings.xml terá precedência.