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 man diese Klasse erweitern, 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 Absicht mit aktion AccountManager#ACTION_AUTHENTICATOR_INTENT
aufgerufen wird. Dieser Dienst muss die folgenden Absichtsfilter- und Metadatentags in seiner 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 Bezeichnungen durch Ihre eigenen Ressourcen. Das android:accountType
Attribut muss eine Zeichenfolge sein, die Ihren Authentifikator eindeutig identifiziert, und es muss dieselbe Zeichenfolge sein, die der Benutzer beim Ausführen von Aufrufen von AccountManager
verwendet, und es entspricht Account#type
auch für Ihre Konten. Ein Benutzer des android:icon ist die Einstellungsseite "Konto & Synchronisierung", und ein Benutzer von android:smallIcon ist der Registerkartenpanel der Kontaktanwendung.
Das preferences-Attribut verweist auf eine PreferenceScreen-XML-Hierarchie, die eine Liste von PreferenceScreens enthält, die zum Verwalten des Authentifikators aufgerufen werden kann. 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üllt, wird dies der Fall sein und ein Bundle
zurückgegeben, das die Ergebnisse enthält. <li> Wenn der Authentifikator Informationen vom Benutzer benötigt, um die Anforderung zu erfüllen, erstellt er eine Intent
für eine Aktivität, 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 endgültige Ergebnis zurückgeben, wenn sie abgeschlossen ist, sodass die Absicht den AccountAuthenticatorResponse
als AccountManager#KEY_ACCOUNT_AUTHENTICATOR_RESPONSE
enthalten sollte. Die Aktivität muss dann oder AccountAuthenticatorResponse#onError
aufrufenAccountAuthenticatorResponse#onResult
, wenn sie abgeschlossen ist. <li> Wenn der Authentifikator die Anforderung nicht synchron verarbeiten und ein Ergebnis zurückgeben kann, kann er null zurückgeben und dann den AccountManagerResponse verwenden, um das Ergebnis zu senden, nachdem die Anforderung abgeschlossen wurde. 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 den möglichen asynchronen Charakter der Anforderungsbehandlung, sondern beschreiben lediglich die Eingabeparameter und das erwartete Ergebnis.
Wenn Sie eine Aktivität schreiben, um diese Anforderungen zu erfüllen, müssen Sie accountManagerResponse übergeben und das Ergebnis über diese Antwort zurückgeben, wenn die Aktivität beendet ist (oder wenn der Aktivitätsautor es für den richtigen Zeitpunkt hält).
Java-Dokumentation für android.accounts.AbstractAccountAuthenticator
.
Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In 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 Runtime aufgerufen. |
Felder
KeyCustomTokenExpiry |
Bündelschlüssel, der für die |
Eigenschaften
Class |
Gibt die Laufzeitklasse dieses |
Handle |
Das Handle für die zugrunde liegende Android-instance. (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 vom Authentifikator instance eines anderen Benutzers auf dem Gerät bereitgestellt werden, der das Konto für diesen Benutzer freigegeben 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 durch #startAddAccountSession oder #startUpdateCredentials gestartet wurde, indem das Konto auf dem Gerät mit AccountManager 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) |
Fragen Sie den Authenticator nach einer lokalisierten 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 eine Aktualisierung der Kontoanmeldeinformationen vorgeschlagen wird. |
JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object) |
Notify() |
Aktiviert einen einzelnen Thread, der auf den Monitor dieses Objekts wartet. (Geerbt von Object) |
NotifyAll() |
Aktiviert alle Threads, die auf den 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 Account-Sitzung, 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, verschiebt jedoch die Aktualisierung der lokal gespeicherten Anmeldeinformationen. |
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 aktiviert ist, in der Regel durch <>Benachrichtigung</em> oder <em>interrupted</em>. (Geerbt von Object) |
Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch>< Benachrichtigung</em> oder <em>interrupted</em>, oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch>< Benachrichtigung</em> oder <em>interrupted</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 Typkonvertierung mit Überprüfung der Android-Laufzeit aus. |
JavaCast<TResult>(IJavaObject) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. |
GetJniTypeName(IJavaPeerable) |
Abstrakte Basisklasse zum Erstellen von AccountAuthenticators. |