AccountManager Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Essa classe fornece acesso a um registro centralizado das contas online do usuário.
[Android.Runtime.Register("android/accounts/AccountManager", DoNotGenerateAcw=true)]
public class AccountManager : Java.Lang.Object
[<Android.Runtime.Register("android/accounts/AccountManager", DoNotGenerateAcw=true)>]
type AccountManager = class
inherit Object
- Herança
- Atributos
Comentários
Essa classe fornece acesso a um registro centralizado das contas online do usuário. O usuário insere credenciais (nome de usuário e senha) uma vez por conta, concedendo aos aplicativos acesso a recursos online com aprovação de "um clique".
Diferentes serviços online têm diferentes maneiras de lidar com contas e autenticação, portanto, o gerenciador de contas usa módulos de autenticador conectáveis para diferentes tipos de conta. Os autenticadores (que podem ser gravados por terceiros) lidam com os detalhes reais da validação das credenciais da conta e do armazenamento de informações da conta. Por exemplo, Google, Facebook e Microsoft Exchange cada um tem seu próprio autenticador.
Muitos servidores dão suporte a alguma noção de um token de autenticação, que pode ser usado para autenticar uma solicitação no servidor sem enviar a senha real do usuário. (Os tokens de autenticação normalmente são criados com uma solicitação separada que inclui as credenciais do usuário.) AccountManager pode gerar tokens de autenticação para aplicativos, portanto, o aplicativo não precisa lidar diretamente com senhas. Os tokens de autenticação normalmente são reutilizáveis e armazenados em cache pelo AccountManager, mas devem ser atualizados periodicamente. É responsabilidade dos aplicativos invalidar tokens de autenticação quando eles param de funcionar para que o AccountManager saiba que precisa regenerizá-los.
Os aplicativos que acessam um servidor normalmente passam por estas etapas:
<ul><li>Obter uma instância de AccountManager usando #get(Context).
<li>Listar as contas disponíveis usando #getAccountsByType ou #getAccountsByTypeAndFeatures. Normalmente, os aplicativos só estarão interessados em contas com um tipo específico, que identifica o autenticador. Os recursos da conta são usados para identificar subtipos e recursos de conta específicos. O tipo de conta e os recursos são cadeias de caracteres específicas do autenticador e devem ser conhecidos pelo aplicativo em coordenação com seus autenticadores preferenciais.
<li>Selecione uma ou mais das contas disponíveis, possivelmente solicitando ao usuário sua preferência. Se nenhuma conta adequada estiver disponível, #addAccount poderá ser chamada para solicitar que o usuário crie uma conta do tipo apropriado.
<li><b>Importante:</b> Se o aplicativo estiver usando uma seleção de conta lembrada anteriormente, ele deve verificar se a conta ainda está na lista de contas retornadas por #getAccountsByType. A solicitação de um token de autenticação para uma conta que não está mais no dispositivo resulta em uma falha indefinida.
<li>Solicitar um token de autenticação para as contas selecionadas usando um dos #getAuthToken métodos ou auxiliares relacionados. Consulte a descrição de cada método para obter detalhes exatos de uso e tratamento de erros.
<li>Fazer a solicitação usando o token de autenticação. A forma do token de autenticação, o formato da solicitação e o protocolo usado são todos específicos para o serviço que você está acessando. O aplicativo pode usar qualquer rede e bibliotecas de protocolo que sejam úteis.
<li><b>Importante:</b> Se a solicitação falhar com um erro de autenticação, pode ser que um token de autenticação armazenado em cache esteja obsoleto e não seja mais respeitado pelo servidor. O aplicativo deve chamar #invalidateAuthToken para remover o token do cache, caso contrário, as solicitações continuarão falhando! Depois de invalidar o token de autenticação, volte imediatamente para a etapa "Solicitar um token de autenticação" acima. Se o processo falhar na segunda vez, ele poderá ser tratado como uma falha de autenticação "genuína" e o usuário notificado ou outras ações apropriadas tomadas.
</ul>
Alguns métodos AccountManager podem precisar interagir com o usuário para solicitar credenciais, apresentar opções ou solicitar que o usuário adicione uma conta. O chamador pode escolher se deseja permitir que AccountManager inicie diretamente a interface do usuário necessária e aguarde o usuário ou retorne uma Intenção que o chamador pode usar para iniciar a interface ou (em alguns casos) para instalar uma notificação que o usuário pode selecionar a qualquer momento para iniciar a interface. Para que o AccountManager inicie a interface diretamente, o chamador deve fornecer o contexto de primeiro plano Activity atual.
Muitos métodos AccountManager tomam AccountManagerCallback e Handler como parâmetros. Esses métodos retornam imediatamente e são executados de forma assíncrona. Se um retorno de chamada for fornecido, será AccountManagerCallback#run invocado no thread do Manipulador quando a solicitação for concluída, com êxito ou não. O resultado é recuperado chamando AccountManagerFuture#getResult() o AccountManagerFuture método retornado (e também passado para o retorno de chamada). Esse método aguarda a conclusão da operação (se necessário) e retorna o resultado ou gera uma exceção se ocorreu um erro durante a operação. Para fazer a solicitação de forma síncrona, chame AccountManagerFuture#getResult() imediatamente ao receber o futuro do método; nenhum retorno de chamada precisa ser fornecido.
As solicitações que podem bloquear, inclusive AccountManagerFuture#getResult(), nunca devem ser chamadas no thread de evento principal do aplicativo. Essas operações serão geradas IllegalStateException se forem usadas no thread principal.
Java documentação para android.accounts.AccountManager.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Construtores
| Nome | Descrição |
|---|---|
| AccountManager(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
Campos
| Nome | Descrição |
|---|---|
| ActionAccountRemoved |
Ação enviada como uma intenção de difusão pelo AccountsService quando qualquer conta é removida ou renomeada. |
| ActionAuthenticatorIntent |
Identifica a ação de intenção usada para descobrir serviços de autenticador de conta. |
| AuthenticatorAttributesName |
Identifica o elemento XML raiz usado ao analisar os metadados de serviço de um autenticador. |
| AuthenticatorMetaDataName |
Identifica a entrada de metadados de serviço que contém uma descrição de autenticador de conta. |
| ErrorCodeBadArguments |
Obsoleto.
Identifica um erro de conta que o tratamento de resultados converte em uma exceção de argumento inválido. |
| ErrorCodeBadAuthentication |
Obsoleto.
O identificador de erro da API de |
| ErrorCodeBadRequest |
Obsoleto.
Identifica uma solicitação de conta incorreta, incluindo um pacote de sessão de conta que não pode ser descriptografado. |
| ErrorCodeCanceled |
Obsoleto.
Identifica uma solicitação de conta que foi cancelada. |
| ErrorCodeInvalidResponse |
Obsoleto.
Identifica uma resposta ausente ou inválida de um autenticador de conta. |
| ErrorCodeNetworkError |
Obsoleto.
Identifica um erro de conta que o tratamento de resultados converte em uma falha de E/S. |
| ErrorCodeRemoteException |
Obsoleto.
Identifica uma chamada de serviço de conta ou falha de conexão, incluindo exceções remotas e desconexão. |
| ErrorCodeUnsupportedOperation |
Obsoleto.
Identifica uma solicitação de conta para uma operação que o autenticador não dá suporte. |
| KeyAccountAuthenticatorResponse |
Identifica o extra de intenção que leva a resposta do autenticador de conta a uma atividade de autenticação. |
| KeyAccountManagerResponse |
Identifica o extra de intenção que carrega a resposta usada para retornar uma opção de conta ao gerenciador de contas. |
| KeyAccountName |
Chave de pacote usada para o nome da |
| KeyAccounts |
Identifica a entrada de pacote que contém objetos de conta retornados por uma consulta de conta. |
| KeyAccountSessionBundle |
Chave de pacote usada para um |
| KeyAccountStatusToken |
Chave de pacote usada para o |
| KeyAccountType |
Chave de pacote usada para o |
| KeyAndroidPackageName |
O pacote android do chamador será definido no pacote de opções pelo |
| KeyAuthenticatorTypes |
A constante de cadeia de caracteres da API de |
| KeyAuthFailedMessage |
Identifica a mensagem de pacote de resultados usada em uma notificação de falha de entrada da conta. |
| KeyAuthtoken |
Chave de pacote usada para o valor do token de autenticação em resultados de |
| KeyAuthTokenLabel |
Identifica a entrada de pacote de resultados que contém um rótulo de token de autenticação. |
| KeyBooleanResult |
Identifica a entrada de pacote de resultados que contém um resultado de operação de conta booliana. |
| KeyCallerPid |
A ID do processo do aplicativo de chamador. |
| KeyCallerUid |
A UID do aplicativo de chamadas. |
| KeyErrorCode |
Identifica a entrada do pacote de resultados que contém um código de erro de conta. |
| KeyErrorMessage |
Identifica a entrada do pacote de resultados que contém uma mensagem de erro de conta. |
| KeyIntent |
Chave de pacote usada para resultados |
| KeyLastAuthenticatedTime |
Chave de pacote usada para fornecer a última vez que as credenciais da conta foram autenticadas com êxito. |
| KeyPassword |
Chave de pacote usada para fornecer a senha diretamente em opções para |
| KeyUserdata |
A constante de cadeia de caracteres da API de |
| LoginAccountsChangedAction |
Ação enviada como uma intenção de difusão pelo AccountsService quando as contas são adicionadas, as contas são removidas ou as credenciais de uma conta (senha salva etc) são alteradas. |
| PackageNameKeyLegacyNotVisible |
Chave para definir a visibilidade padrão para aplicativos que não atendem às condições em |
| PackageNameKeyLegacyVisible |
Chave para definir a visibilidade de aplicativos que atendem a uma das seguintes condições: <ul><li>nível de API de destino abaixo |
Propriedades
| Nome | Descrição |
|---|---|
| Class |
Retorna a classe de runtime deste |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniManagedPeerState |
Obtém os sinalizadores de estado atribuídos pela última vez pelo runtime. (Herdado de JavaObject) |
| JniPeerMembers |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| ThresholdClass |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| ThresholdType |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
Métodos
| Nome | Descrição |
|---|---|
| AddAccount(String, String, String[], Bundle, Activity, IAccountManagerCallback, Handler) |
Pede ao usuário para adicionar uma conta de um tipo especificado. |
| AddAccountExplicitly(Account, String, Bundle, IDictionary<String,Integer>) |
Adiciona uma conta diretamente ao AccountManager. |
| AddAccountExplicitly(Account, String, Bundle) |
Adiciona uma conta diretamente ao AccountManager. |
| AddOnAccountsUpdatedListener(IOnAccountsUpdateListener, Handler, Boolean, String[]) |
Adiciona uma |
| AddOnAccountsUpdatedListener(IOnAccountsUpdateListener, Handler, Boolean) |
Adiciona uma |
| BlockingGetAuthToken(Account, String, Boolean) |
Esse auxiliar de conveniência obtém de forma síncrona um token de autenticação com |
| ClearPassword(Account) |
Esquece uma senha salva. |
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| ConfirmCredentials(Account, Bundle, Activity, IAccountManagerCallback, Handler) |
Confirma que o usuário sabe a senha de uma conta para garantir que ele seja o proprietário da conta. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Delega a construção desse par ao gerenciador de valores do runtime. (Herdado de JavaObject) |
| Dispose() |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| Dispose(Boolean) |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| DisposeUnlessReferenced() |
Pede ao gerenciador de valores para descartar esse par, a menos que seu mapeamento mantenha essa mesma instância gerenciada. (Herdado de JavaObject) |
| EditProperties(String, Activity, IAccountManagerCallback, Handler) |
Oferece ao usuário uma oportunidade de alterar as configurações de um autenticador. |
| Equals(Object) |
Testa se outro par gerenciado se refere ao mesmo objeto Java. (Herdado de JavaObject) |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| FinishSession(Bundle, Activity, IAccountManagerCallback, Handler) |
Conclui a sessão iniciada por |
| FromContext(Context) |
Obtém uma instância do gerenciador de contas associada a um contexto. |
| Get(Context) |
Obtém uma instância AccountManager associada a um Contexto. |
| GetAccounts() |
Lista todas as contas visíveis para o chamador, independentemente do tipo. |
| GetAccountsAndVisibilityForPackage(String, String) |
Obtém todas as contas de determinado tipo e sua visibilidade para um pacote específico. |
| GetAccountsByType(String) |
Lista todas as contas de determinado tipo visíveis para o chamador. |
| GetAccountsByTypeAndFeatures(String, String[], IAccountManagerCallback, Handler) |
Lista todas as contas de um tipo que têm determinados recursos. |
| GetAccountsByTypeForPackage(String, String) |
Retorna as contas visíveis para o pacote especificado em um ambiente em que alguns aplicativos não estão autorizados a exibir todas as contas. |
| GetAccountVisibility(Account, String) |
Obtenha visibilidade de determinada conta para determinado aplicativo. |
| GetAuthenticatorTypes() |
Lista os autenticadores registrados no momento. |
| GetAuthToken(Account, String, Boolean, IAccountManagerCallback, Handler) |
Obsoleto.
Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais. |
| GetAuthToken(Account, String, Bundle, Activity, IAccountManagerCallback, Handler) |
Obtém um token de autenticação do tipo especificado para uma conta específica, solicitando ao usuário credenciais, se necessário. |
| GetAuthToken(Account, String, Bundle, Boolean, IAccountManagerCallback, Handler) |
Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais. |
| GetAuthTokenByFeatures(String, String, String[], Activity, Bundle, Bundle, IAccountManagerCallback, Handler) |
Esse auxiliar de conveniência combina a funcionalidade de |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| GetPackagesAndVisibilityForAccount(Account) |
Retorna nomes de pacote e visibilidade que foram explicitamente definidos para determinada conta. |
| GetPassword(Account) |
Obtém a senha salva associada à conta. |
| GetPreviousName(Account) |
Obtém o nome anterior associado à conta ou |
| GetUserData(Account, String) |
Obtém os dados do usuário nomeados por "chave" associados à conta. |
| HasFeatures(Account, String[], IAccountManagerCallback, Handler) |
Descobre se uma conta específica tem todos os recursos especificados. |
| InvalidateAuthToken(String, String) |
Remove um token de autenticação do cache do AccountManager. |
| IsCredentialsUpdateSuggested(Account, String, IAccountManagerCallback, Handler) |
Verifica se |
| JavaFinalize() |
Obsoleto.
Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object) |
| NewChooseAccountIntent(Account, IList<Account>, String[], Boolean, String, String, String[], Bundle) |
Obsoleto.
Preterido em favor de |
| NewChooseAccountIntent(Account, IList<Account>, String[], String, String, String[], Bundle) |
Retorna uma intenção para um |
| Notify() |
Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object) |
| NotifyAccountAuthenticated(Account) |
Notifica o sistema de que a conta acabou de ser autenticada. |
| NotifyAll() |
Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object) |
| PeekAuthToken(Account, String) |
Obtém um token de autenticação do cache do AccountManager. |
| RemoveAccount(Account, Activity, IAccountManagerCallback, Handler) |
Remove uma conta do AccountManager. |
| RemoveAccount(Account, IAccountManagerCallback, Handler) |
Obsoleto.
Remove uma conta do AccountManager. |
| RemoveAccountExplicitly(Account) |
Remove uma conta diretamente. |
| RemoveOnAccountsUpdatedListener(IOnAccountsUpdateListener) |
Remove um |
| RenameAccount(Account, String, IAccountManagerCallback, Handler) |
Renomeie o especificado |
| SetAccountVisibility(Account, String, AccountVisibility) |
Defina o valor de visibilidade de determinada conta para determinado pacote. |
| SetAuthToken(Account, String, String) |
Adiciona um token de autenticação ao cache AccountManager para uma conta. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| SetPassword(Account, String) |
Define ou esquece uma senha salva. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Armazena um valor de referência no bloco de controle sem criar uma cópia de referência JNI. (Herdado de JavaObject) |
| SetUserData(Account, String, String) |
Define uma chave userdata para uma conta. |
| StartAddAccountSession(String, String, String[], Bundle, Activity, IAccountManagerCallback, Handler) |
Solicita que o usuário se autentique com uma conta de um tipo especificado. |
| StartUpdateCredentialsSession(Account, String, Bundle, Activity, IAccountManagerCallback, Handler) |
Solicita que o usuário insira uma nova senha para a conta, mas não atualize as credenciais salvas para a conta até |
| ToArray<T>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| UnregisterFromRuntime() |
Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object) |
| UpdateCredentials(Account, String, Bundle, Activity, IAccountManagerCallback, Handler) |
Solicita que o usuário insira uma nova senha para uma conta, atualizando as credenciais salvas para a conta. |
| Wait() |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser notificado ou interrompido. (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser notificado ou interrompido, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| Wait(Int64) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser notificado ou interrompido, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
Eventos
| Nome | Descrição |
|---|---|
| AccountsUpdated |
Ocorre quando o usuário ou um autenticador altera contas relacionadas ao chamador. |
Implantações explícitas de interface
| Nome | Descrição |
|---|---|
| IJavaPeerable.Disposed() |
Marca esse par como descartado e chama |
| IJavaPeerable.Finalized() |
Marca esse par como descartado e chama |
| IJavaPeerable.JniObjectReferenceControlBlock |
Obtém o ponteiro de bloco de controle nativo usado por esse par. (Herdado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Armazena o código de hash de identidade fornecido pelo runtime. (Herdado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Substitui os sinalizadores de estado de par gerenciado armazenados. (Herdado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Atualiza a referência de par e libera o bloco de controle de um par descartado quando a referência é inválida. (Herdado de JavaObject) |
Métodos de Extensão
| Nome | Descrição |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
Reutiliza um par gerenciado compatível ou obtém um wrapper do tipo solicitado. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |