AbstractAccountAuthenticator Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

AbstractAccountAuthenticator

Attribute

RegisterAttribute

Hinweise

Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. Um ein Authentifikator zu sein, muss diese Klasse erweitert werden, Implementierungen für die abstrakten Methoden bereitstellen und einen Dienst schreiben, der das Ergebnis des #getIBinder() Diensts android.app.Service#onBind(android.content.Intent) zurückgibt, wenn er mit einer Aktion AccountManager#ACTION_AUTHENTICATOR_INTENTaufgerufen wird. Dieser Dienst muss die folgenden Absichtsfilter- und Metadatentags in der AndroidManifest.xml Datei angeben.

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

Das android:resource Attribut muss auf eine Ressource verweisen, die wie folgt aussieht:

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

Ersetzen Sie die Symbole und Beschriftungen durch Ihre eigenen Ressourcen. Das android:accountType Attribut muss eine Zeichenfolge sein, die Ihren Authentifikator eindeutig identifiziert und die gleiche Zeichenfolge sein wird, die der Benutzer beim Tätigen von Aufrufen verwendet AccountManager , und es entspricht Account#type auch für Ihre Konten. Ein Benutzer des Android:icon ist die Einstellungsseite "Konto & Synchronisierung", und ein Benutzer des Android:smallIcon ist die Registerkartenbereiche der Kontaktanwendung.

Das Attribut "PreferenceScreen" verweist auf eine "PreferenceScreen"-XML-Hierarchie, die eine Liste von PreferenceScreens enthält, die aufgerufen werden können, um den Authentifikator zu verwalten. Ein Beispiel ist:

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

Das Standardmuster für die Implementierung einer der abstrakten Methoden lautet wie folgt: <ul><li> Wenn die angegebenen Argumente ausreichen, damit der Authentifikator die Anforderung vollständig erfüllen kann, wird dies ausgeführt und ein Bundle Objekt zurückgegeben, das die Ergebnisse enthält. <li> Wenn der Authentifikator Informationen vom Benutzer benötigt, um die Anforderung zu erfüllen, wird eine Aktivität erstellt Intent , die den Benutzer zur Eingabe der Informationen auffordert und dann die Anforderung durchführt. Diese Absicht muss in einem Bundle als Schlüssel AccountManager#KEY_INTENTzurückgegeben werden.

Die Aktivität muss das endende Ergebnis zurückgeben, wenn sie abgeschlossen ist, damit die Absicht folgendes AccountAuthenticatorResponseAccountManager#KEY_ACCOUNT_AUTHENTICATOR_RESPONSEenthalten soll: Die Aktivität muss dann aufgerufen AccountAuthenticatorResponse#onResult oder AccountAuthenticatorResponse#onError nach Abschluss der Aktivität aufgerufen werden. <li> If the authenticator cannot synchron process the request and return a result then it may choose to return null and then use the AccountManagerResponse to send the result when it has completed the request. Diese asynchrone Option ist für die #addAccount Methode nicht verfügbar, die synchron abgeschlossen werden muss. </ul>

Die folgenden Beschreibungen der einzelnen abstrakten Authentifikatormethoden beschreiben nicht die mögliche asynchrone Art der Anforderungsverarbeitung und beschreiben stattdessen nur die Eingabeparameter und das erwartete Ergebnis.

Beim Schreiben einer Aktivität, um diese Anforderungen zu erfüllen, muss man das AccountManagerResponse übergeben und das Ergebnis über diese Antwort zurückgeben, wenn die Aktivität abgeschlossen ist (oder wenn der Aktivitätsautor die richtige Zeit für die Antwort hält).

Java Dokumentation für android.accounts.AbstractAccountAuthenticator.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.