AbstractAccountAuthenticator Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

AbstractAccountAuthenticator

Attributi

RegisterAttribute

Commenti

Classe base astratta per la creazione di AccountAuthenticators. Per essere un autenticatore, è necessario estendere questa classe, fornire implementazioni per i metodi astratti e scrivere un servizio che restituisce il risultato di #getIBinder() quando viene richiamato con una finalità con l'azione android.app.Service#onBind(android.content.Intent)AccountManager#ACTION_AUTHENTICATOR_INTENT. Questo servizio deve specificare i tag di filtro delle finalità e metadati seguenti nel relativo file di AndroidManifest.xml

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

L'attributo android:resource deve puntare a una risorsa simile alla seguente:

<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"
            />

Sostituire le icone e le etichette con le proprie risorse. L'attributo android:accountType deve essere una stringa che identifica in modo univoco l'autenticatore e sarà la stessa stringa che l'utente userà quando effettua chiamate su AccountManager e corrisponde anche per Account#type gli account. Un utente dell'icona android:icon è la pagina delle impostazioni "Account & Sync" e un utente di android:smallIcon è il pannello scheda dell'applicazione contatto.

L'attributo preferences punta a una gerarchia xml PreferenceScreen che contiene un elenco di PreferenceScreen che possono essere richiamati per gestire l'autenticatore. Di seguito è riportato un esempio:

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

Il modello standard per l'implementazione di uno dei metodi astratti è il seguente: <ul><li> Se gli argomenti forniti sono sufficienti per l'autenticatore per soddisfare completamente la richiesta, lo eseguirà e restituirà un oggetto Bundle contenente i risultati. <li> Se l'autenticatore necessita di informazioni dall'utente per soddisfare la richiesta, creerà un Intent oggetto a un'attività che richiederà all'utente le informazioni e quindi eseguirà la richiesta. Questa finalità deve essere restituita in un bundle come chiave AccountManager#KEY_INTENT.

L'attività deve restituire il risultato finale al termine, in modo che la finalità contenga AccountAuthenticatorResponse come AccountManager#KEY_ACCOUNT_AUTHENTICATOR_RESPONSE. L'attività deve quindi chiamare AccountAuthenticatorResponse#onResult o AccountAuthenticatorResponse#onError al termine. <li> Se l'autenticatore non è in grado di elaborare in modo sincrono la richiesta e restituire un risultato, può scegliere di restituire null e quindi usare AccountManagerResponse per inviare il risultato al termine della richiesta. Questa opzione asincrona non è disponibile per il #addAccount metodo , che deve essere completata in modo sincrono. </ul>

Le descrizioni seguenti di ogni metodo di autenticazione astratta non descrivono la possibile natura asincrona della gestione delle richieste e descrivono semplicemente i parametri di input e il risultato previsto.

Quando si scrive un'attività per soddisfare queste richieste, è necessario passare accountManagerResponse e restituire il risultato tramite tale risposta al termine dell'attività (o ogni volta che l'autore dell'attività ritiene che sia il momento corretto per rispondere).

per android.accounts.AbstractAccountAuthenticator.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.