AbstractAccountAuthenticator Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators.
[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
- Attribute
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_INTENT
aufgerufen 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. Im folgenden Code wird ein Beispiel veranschaulicht:
<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_INTENT
zurückgegeben werden.
Die Aktivität muss das endende Ergebnis zurückgeben, wenn sie abgeschlossen ist, damit die Absicht folgendes AccountAuthenticatorResponse
AccountManager#KEY_ACCOUNT_AUTHENTICATOR_RESPONSE
enthalten 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 vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
AbstractAccountAuthenticator(Context) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. |
AbstractAccountAuthenticator(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen. |
Felder
KeyCustomTokenExpiry |
Bündelschlüssel, der für die |
Eigenschaften
Class |
Gibt die Laufzeitklasse dieses Werts |
Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
IBinder |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. |
JniIdentityHashCode |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
JniPeerMembers |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. |
PeerReference |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
Methoden
AddAccount(AccountAuthenticatorResponse, String, String, String[], Bundle) |
Fügt ein Konto des angegebenen accountType hinzu. |
AddAccountFromCredentials(AccountAuthenticatorResponse, Account, Bundle) |
Erstellt ein Konto basierend auf den Anmeldeinformationen, die von der Authentifikatorinstanz eines anderen Benutzers auf dem Gerät bereitgestellt werden, der sich für die Freigabe des Kontos für diesen Benutzer entschieden hat. |
Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
ConfirmCredentials(AccountAuthenticatorResponse, Account, Bundle) |
Überprüft, ob der Benutzer die Anmeldeinformationen eines Kontos kennt. |
Dispose() |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
Dispose(Boolean) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
EditProperties(AccountAuthenticatorResponse, String) |
Gibt ein Bundle zurück, das die Absicht der Aktivität enthält, die zum Bearbeiten der Eigenschaften verwendet werden kann. |
Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
FinishSession(AccountAuthenticatorResponse, String, Bundle) |
Beendet die sitzung, die von #startAddAccountSession oder #startUpdateCredentials gestartet wurde, indem das Konto mit AccountManager auf dem Gerät installiert oder die lokalen Anmeldeinformationen aktualisiert werden. |
GetAccountCredentialsForCloning(AccountAuthenticatorResponse, Account) |
Gibt ein Bundle zurück, das alles enthält, was zum Klonen des Kontos für einen anderen Benutzer erforderlich ist. |
GetAccountRemovalAllowed(AccountAuthenticatorResponse, Account) |
Überprüft, ob das Entfernen dieses Kontos zulässig ist. |
GetAuthToken(AccountAuthenticatorResponse, Account, String, Bundle) |
Ruft ein Authentifizierungstoken für ein Konto ab. |
GetAuthTokenLabel(String) |
Bitten Sie den Authentifikator um eine lokalisierte Bezeichnung für den angegebenen authTokenType. |
GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
HasFeatures(AccountAuthenticatorResponse, Account, String[]) |
Überprüft, ob das Konto alle angegebenen Authentifikator-spezifischen Features unterstützt. |
IsCredentialsUpdateSuggested(AccountAuthenticatorResponse, Account, String) |
Überprüft, ob die Aktualisierung der Kontoanmeldeinformationen vorgeschlagen wird. |
JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
StartAddAccountSession(AccountAuthenticatorResponse, String, String, String[], Bundle) |
Startet die Add-Kontositzung, um den Benutzer bei einem Konto des angegebenen accountType zu authentifizieren. |
StartUpdateCredentialsSession(AccountAuthenticatorResponse, Account, String, Bundle) |
Fordert den Benutzer auf, sich für ein Konto erneut zu authentifizieren, die lokal gespeicherten Anmeldeinformationen werden jedoch zurückgestellt. |
ToArray<T>() |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
UnregisterFromRuntime() |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
UpdateCredentials(AccountAuthenticatorResponse, Account, String, Bundle) |
Aktualisieren Sie die lokal gespeicherten Anmeldeinformationen für ein Konto. |
Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object) |
Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
IJavaPeerable.Disposed() |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
IJavaPeerable.DisposeUnlessReferenced() |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
IJavaPeerable.Finalized() |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
IJavaPeerable.JniManagedPeerState |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. (Geerbt von Object) |
Erweiterungsmethoden
JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
JavaCast<TResult>(IJavaObject) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. |
GetJniTypeName(IJavaPeerable) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. |