AbstractAccountAuthenticator Classe

Definição

[Android.Runtime.Register("android/accounts/AbstractAccountAuthenticator", DoNotGenerateAcw=true)]
public abstract class AbstractAccountAuthenticator : Java.Lang.Object

[<Android.Runtime.Register("android/accounts/AbstractAccountAuthenticator", DoNotGenerateAcw=true)>]
type AbstractAccountAuthenticator = class
    inherit Object

Herança

Object

JavaObject

Object

AbstractAccountAuthenticator

Atributos

RegisterAttribute

Comentários

Classe base abstrata para criar AccountAuthenticators. Para ser um autenticador, é necessário estender essa classe, fornecer implementações para os métodos abstratos e gravar um serviço que retorna o resultado do #getIBinder() serviço android.app.Service#onBind(android.content.Intent) quando invocado com uma intenção com a ação AccountManager#ACTION_AUTHENTICATOR_INTENT. Esse serviço deve especificar as seguintes marcas de filtro de intenção e metadados em seu arquivo AndroidManifest.xml

<intent-filter>
                <action android:name="android.accounts.AccountAuthenticator" />
              </intent-filter>
              <meta-data android:name="android.accounts.AccountAuthenticator"
                        android:resource="@xml/authenticator" />

O android:resource atributo deve apontar para um recurso semelhante a:

<account-authenticator xmlns:android="http://schemas.android.com/apk/res/android"
               android:accountType="typeOfAuthenticator"
               android:icon="@drawable/icon"
               android:smallIcon="@drawable/miniIcon"
               android:label="@string/label"
               android:accountPreferences="@xml/account_preferences"
            />

Substitua os ícones e rótulos por seus próprios recursos. O android:accountType atributo deve ser uma cadeia de caracteres que identifique exclusivamente o autenticador e será a mesma cadeia de caracteres que o usuário usará ao fazer chamadas e AccountManager também corresponde às Account#type suas contas. Um usuário do android:icon é a página de configurações "Conta &sincronização" e um usuário do android:smallIcon são os painéis de guias do Aplicativo de Contato.

O atributo de preferências aponta para uma hierarquia xml PreferenceScreen que contém uma lista de PreferenceScreens que podem ser invocadas para gerenciar o autenticador. Um exemplo é:

<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
               <PreferenceCategory android:title="@string/title_fmt" />
               <PreferenceScreen
                    android:key="key1"
                    android:title="@string/key1_action"
                    android:summary="@string/key1_summary">
                    <intent
                        android:action="key1.ACTION"
                        android:targetPackage="key1.package"
                        android:targetClass="key1.class" />
                </PreferenceScreen>
            </PreferenceScreen>

O padrão padrão para implementar qualquer um dos métodos abstratos é o seguinte: <ul><li> Se os argumentos fornecidos forem suficientes para que o autenticador atenda totalmente à solicitação, ele o fará e retornará um Bundle que contenha os resultados. <li> Se o autenticador precisar de informações do usuário para atender à solicitação, ele criará uma Intent atividade que solicitará ao usuário as informações e, em seguida, realizará a solicitação. Essa intenção deve ser retornada em um Pacote como chave AccountManager#KEY_INTENT.

A atividade precisa retornar o resultado final quando for concluída, portanto, a Intenção deve conter como AccountAuthenticatorResponseAccountManager#KEY_ACCOUNT_AUTHENTICATOR_RESPONSE. Em seguida, a atividade deve chamar AccountAuthenticatorResponse#onResult ou AccountAuthenticatorResponse#onError quando for concluída. <li> Se o autenticador não puder processar a solicitação de forma síncrona e retornar um resultado, ele poderá optar por retornar nulo e, em seguida, usar o AccountManagerResponse para enviar o resultado quando tiver concluído a solicitação. Essa opção assíncrona não está disponível para o #addAccount método, que deve ser concluído de forma síncrona. </ul>

As descrições a seguir de cada um dos métodos de autenticador abstrato não descreverão a natureza assíncrona possível do tratamento da solicitação e, em vez disso, apenas descreverão os parâmetros de entrada e o resultado esperado.

Ao escrever uma atividade para atender a essas solicitações, é necessário passar o AccountManagerResponse e retornar o resultado por meio dessa resposta quando a atividade for concluída (ou sempre que o autor da atividade considerar que é o momento correto para responder).

Java documentação para android.accounts.AbstractAccountAuthenticator.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.