AbstractAccountAuthenticator Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Clase base abstracta para crear 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
- Herencia
- Atributos
Comentarios
Clase base abstracta para crear AccountAuthenticators. Para ser un autenticador, debe extender esta clase, proporcionar implementaciones para los métodos abstractos y escribir un servicio que devuelva el resultado de #getIBinder() en el servicio android.app.Service#onBind(android.content.Intent) cuando se invoca con una intención con la acción AccountManager#ACTION_AUTHENTICATOR_INTENT. Este servicio debe especificar las siguientes etiquetas de filtro de intención y metadatos en su archivo AndroidManifest.xml
<intent-filter>
<action android:name="android.accounts.AccountAuthenticator" />
</intent-filter>
<meta-data android:name="android.accounts.AccountAuthenticator"
android:resource="@xml/authenticator" />
El android:resource atributo debe apuntar a un recurso similar al siguiente:
<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"
/>
Reemplace los iconos y etiquetas por sus propios recursos. El android:accountType atributo debe ser una cadena que identifique de forma única el autenticador y será la misma cadena que el usuario usará al realizar llamadas en y AccountManager también corresponde a Account#type para sus cuentas. Un usuario del android:icon es la página de configuración "Cuenta y sincronización" y un usuario de android:smallIcon es los paneles de pestañas de la aplicación de contacto.
El atributo preferences apunta a una jerarquía xml PreferenceScreen que contiene una lista de PreferenceScreens que se pueden invocar para administrar el autenticador. Ejemplo:
<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>
El patrón estándar para implementar cualquiera de los métodos abstractos es el siguiente: <ul><li> Si los argumentos proporcionados son suficientes para que el autenticador satisfaga completamente la solicitud, lo hará y devolverá un Bundle que contenga los resultados.
<li> Si el autenticador necesita información del usuario para satisfacer la solicitud, creará una en Intent una actividad que solicitará al usuario la información y, a continuación, llevará a cabo la solicitud. Esta intención debe devolverse en un paquete como clave AccountManager#KEY_INTENT.
La actividad debe devolver el resultado final cuando se complete, por lo que la intención debe contener AccountAuthenticatorResponse como AccountManager#KEY_ACCOUNT_AUTHENTICATOR_RESPONSE. A continuación, la actividad debe llamar a AccountAuthenticatorResponse#onResult o AccountAuthenticatorResponse#onError cuando se complete.
<li> Si el autenticador no puede procesar sincrónicamente la solicitud y devolver un resultado, puede optar por devolver null y, a continuación, usar AccountManagerResponse para enviar el resultado cuando haya completado la solicitud. Esta opción asincrónica no está disponible para el #addAccount método , que debe completarse sincrónicamente.
</ul>
Las descripciones siguientes de cada uno de los métodos de autenticación abstracta no describirán la posible naturaleza asincrónica del control de solicitudes y, en su lugar, simplemente describirán los parámetros de entrada y el resultado esperado.
Al escribir una actividad para satisfacer estas solicitudes, debe pasar accountManagerResponse y devolver el resultado a través de esa respuesta cuando finaliza la actividad (o siempre que el autor de la actividad considere que es el momento correcto para responder).
Java documentación para android.accounts.AbstractAccountAuthenticator.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| AbstractAccountAuthenticator(Context) |
Inicializa una nueva instancia de la clase AbstractAccountAuthenticator. |
| AbstractAccountAuthenticator(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
Campos
| Nombre | Description |
|---|---|
| KeyCustomTokenExpiry |
Clave de agrupación usada para la |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| IBinder |
Obtiene la interfaz del enlazador a través de la cual el marco llama a este autenticador. |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Obtiene las marcas de estado asignadas por última vez por el tiempo de ejecución. (Heredado de JavaObject) |
| JniPeerMembers |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
Métodos
| Nombre | Description |
|---|---|
| AddAccount(AccountAuthenticatorResponse, String, String, String[], Bundle) |
Agrega una cuenta del accountType especificado. |
| AddAccountFromCredentials(AccountAuthenticatorResponse, Account, Bundle) |
Crea una cuenta basada en las credenciales proporcionadas por la instancia de autenticador de otro usuario en el dispositivo, que ha elegido compartir la cuenta con este usuario. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| ConfirmCredentials(AccountAuthenticatorResponse, Account, Bundle) |
Comprueba que el usuario conoce las credenciales de una cuenta. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Delega la construcción de este elemento del mismo nivel en el administrador de valores del entorno de ejecución. (Heredado de JavaObject) |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Pide al administrador de valores que elimine este elemento del mismo nivel a menos que su asignación conserve esta misma instancia administrada. (Heredado de JavaObject) |
| EditProperties(AccountAuthenticatorResponse, String) |
Devuelve un paquete que contiene la intención de la actividad que se puede usar para editar las propiedades. |
| Equals(Object) |
Comprueba si otro elemento del mismo nivel administrado hace referencia al mismo objeto Java. (Heredado de JavaObject) |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| FinishSession(AccountAuthenticatorResponse, String, Bundle) |
Finaliza la sesión iniciada por #startAddAccountSession o #startUpdateCredentials instalando la cuenta en el dispositivo con AccountManager o actualizando las credenciales locales. |
| GetAccountCredentialsForCloning(AccountAuthenticatorResponse, Account) |
Devuelve un paquete que contiene lo que sea necesario para clonar la cuenta en un usuario diferente. |
| GetAccountRemovalAllowed(AccountAuthenticatorResponse, Account) |
Comprueba si se permite la eliminación de esta cuenta. |
| GetAuthToken(AccountAuthenticatorResponse, Account, String, Bundle) |
Obtiene un authtoken para una cuenta. |
| GetAuthTokenLabel(String) |
Pida al autenticador una etiqueta localizada para el authTokenType especificado. |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| HasFeatures(AccountAuthenticatorResponse, Account, String[]) |
Comprueba si la cuenta admite todas las características específicas del autenticador especificadas. |
| IsCredentialsUpdateSuggested(AccountAuthenticatorResponse, Account, String) |
Comprueba si se sugiere la actualización de las credenciales de la cuenta. |
| JavaFinalize() |
Obsoletos.
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Almacena un valor de referencia en el bloque de control sin crear una copia de referencia de JNI. (Heredado de JavaObject) |
| StartAddAccountSession(AccountAuthenticatorResponse, String, String, String[], Bundle) |
Inicia la sesión de agregar cuenta para autenticar al usuario en una cuenta del accountType especificado. |
| StartUpdateCredentialsSession(AccountAuthenticatorResponse, Account, String, Bundle) |
Pide al usuario que vuelva a autenticarse para una cuenta, pero aplaza la actualización de las credenciales almacenadas localmente. |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| UpdateCredentials(AccountAuthenticatorResponse, Account, String, Bundle) |
Actualice las credenciales almacenadas localmente para una cuenta. |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente mediante la notificación o interrupción. (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se active, normalmente mediante la notificación o interrupción, o hasta que haya transcurrido una determinada cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se active, normalmente mediante la notificación o interrupción, o hasta que haya transcurrido una determinada cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
Marca este elemento del mismo nivel como eliminado y llama |
| IJavaPeerable.Finalized() |
Marca este elemento del mismo nivel como eliminado y llama |
| IJavaPeerable.JniObjectReferenceControlBlock |
Obtiene el puntero de bloque de control nativo usado por este elemento del mismo nivel. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Almacena el código hash de identidad proporcionado por el tiempo de ejecución. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Reemplaza las marcas de estado del mismo nivel administradas almacenadas. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Actualiza la referencia del mismo nivel y libera un bloque de control del mismo nivel eliminado cuando la referencia no es válida. (Heredado de JavaObject) |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Reutiliza un par administrado compatible o obtiene un contenedor del tipo solicitado. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |