ОС-аккаунт

Введение

В стандартной системе подсистема учётных записей ОС реализует управление жизненным циклом учётных записей, управляет распределённым статусом входа в учётную запись и добавляет или удаляет учётные записи приложений.

Архитектура

Рисунок 1. Архитектура модуля учётной записи ОС.

Структура каталогов

/base/account/os_account
├── figures                  Figures
├── frameworks               Code of the account subsystem
│   ├── appaccount           Internal API code of the app account module
│   │   └── native           Code used to implement the app account internal APIs
│   ├── common               Code of the common module
│   │   ├── account_error    Error codes
│   │   ├── database         Database code
│   │   ├── log              Code for printing logs
│   │   ├── perf_stat        Code for performance statistics
│   │   └── test             Test code for the common module
│   ├── ohosaccount         Internal API code of the distributed account module
│   │   ├── native            Code used to implement the distributed account internal APIs
│   │   └── test             Test code for the distributed account internal APIs
│   └── osaccount            Internal API code of the OS account module
│       ├── core             OS account IPC
│       └── native           Code used to implement the OS account internal APIs
├── interfaces               External APIs of the account subsystem
│   ├── innerkits            Internal API header file
│   │   ├── appaccount       Header file of the app account internal APIs
│   │   ├── ohosaccount      Header file of the distributed account internal APIs
│   │   └── osaccount        Header file of the OS account internal APIs
│   └── kits                 External API encapsulation
│       └── napi             External API encapsulation code of the account subsystem
├── sa_profile               SA profile directory of the account subsystem
├── services                accountmgr service code
│   └── accountmgr           Account subsystem service code
│       ├── include          Service code header file
│       ├── src              Source code of the account subsystem service code
│       └── test             Test of the account subsystem service code
├── test                     Test code
│   ├── resource             Test resource files
│   └── systemtest           System test code
└── tools                    Tool code
    ├── acm                  acm tool
    │   ├── include          acm header file
    │   └── src              acm source file
    └── test                 acm test code

Использование

Доступные API

1. Модуль распределённой учётной записи

Модуль распределённой учётной записи предоставляет API для запроса и обновления статуса входа в учётную запись. Эти API могут использоваться только системными приложениями.

Таблица 1. Описание модуля распределённой учётной записи.

Таблица 2. Классы distributedAccount. Таблица 3. Описание DistributedAccountAbility

Таблица 4. Методы DistributedAccountAbility

Добавляет учётную запись приложения.

addAccountImplicitly(owner: string, authType: string, options: {[key: string]: any}, callback: AuthenticatorCallback): void;

Добавляет учётную запись приложения неявно.

deleteAccount(name: string, callback: AsyncCallback): void;

Удаляет учётную запись приложения.

enableAppAccess(name: string, bundleName: string, callback: AsyncCallback): void;

Включает доступ к учётной записи приложения.

disableAppAccess(name: string, bundleName: string, callback: AsyncCallback): void;

Отключает доступ к учётной записи приложения.

checkAppAccountSyncEnable(name: string, callback: AsyncCallback): void;

Проверяет, включена ли синхронизация данных приложения для учётной записи.

setAccountCredential(name: string, credentialType: string, credential: string,callback: AsyncCallback): void;

Устанавливает информацию о полномочиях для учётной записи приложения.

setAccountExtraInfo(name: string, extraInfo: string, callback: AsyncCallback): void;

Задаёт дополнительную информацию для учётной записи приложения. Текст запроса:

class="cellrowborder" valign="top" width="64.72%" headers="mcps1.2.3.1.1 ">

setAppAccountSyncEnable(name: string, isEnable: boolean, callback: AsyncCallback<void>): void;

Устанавливает статус синхронизации для учетной записи приложения.

setAssociatedData(name: string, key: string, value: string, callback: AsyncCallback<void>): void;

Задаёт данные, связанные с учётной записью приложения.

• setAppAccountSyncEnable (name: string, isEnable: boolean, callback: AsyncCallback): void; Устанавливает статус синхронизации для учётной записи приложения.

• setAssociatedData (name: string, key: string, value: string, callback: AsyncCallback): void; Задаёт данные, связанные с учётной записью приложения. off(type: 'change', callback?: Callback): void;

Отписывается от изменений в информации учётной записи приложения.

authenticate(name: string, owner: string, authType: string, options: {[key: string]: any}, callback: AuthenticatorCallback): void;

Аутентифицирует учётную запись приложения для получения токена доступа OAuth.

getOAuthToken(name: string, owner: string, authType: string, callback: AsyncCallback): void;

Получает токен доступа OAuth для учётной записи приложения.

setOAuthToken(name: string, authType: string, token: string, callback: AsyncCallback): void;

Устанавливает токен доступа OAuth для учётной записи приложения.

deleteOAuthToken(name: string, owner: string, authType: string, token: string, callback: AsyncCallback): void;

Удаляет токен доступа OAuth для учётной записи приложения.

setOAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean, callback: AsyncCallback): void;

Устанавливает видимость токена доступа OAuth для учётной записи приложения.

checkOAuthTokenVisibility(name: string, authType: string, bundleName: string, callback: AsyncCallback): void;

Проверяет видимость токена доступа OAuth для учётной записи приложения. Таблица 9 Описание модуля OS account

Таблица 10 Классы osAccount

Таблица 12. Методы AccountManager

AsyncCallback): void; Checks whether multiple OS accounts are supported. This method uses an asynchronous callback to return the result.

isMultiOsAccountEnable(): Promise; Checks whether multiple OS accounts are supported. This method uses a promise to return the result.

isOsAccountActived(localId: number, callback: AsyncCallback): void; Checks whether an OS account is activated. This method uses an asynchronous callback to return the result.

isOsAccountActived(localId: number): Promise; Checks whether an OS account is activated. This method uses a promise to return the result.

isOsAccountConstraintEnable(localId: number, constraint: string, callback: AsyncCallback): void; Checks whether an OS account has the given constraints. This method uses an asynchronous callback to return the результат.

isOsAccountConstraintEnable(localId: number, constraint: string): Promise; Checks whether an OS account has the given constraints. This метод использует обещание для возврата результата.

isTestOsAccount(callback: AsyncCallback): void; Проверяет, является ли данная учётная запись операционной системы тестовой. Этот метод использует асинхронный обратный вызов для возврата результата.

isTestOsAccount(): Promise; Проверяет, является ли данная учётная запись операционной системы тестовой.

Перевод текста на русский язык:

AsyncCallback<логическое значение>): пусто; Проверяет поддержку нескольких учётных записей ОС. Данный метод использует асинхронный обратный вызов для возвращения результата.

isMultiOsAccountEnable(): обещание<логическое значение> Проверяет поддержку нескольких учётных записей ОС. Данный метод использует обещание для возвращения результата.

isOsAccountActived (localId: число, обратный вызов: AsyncCallback<логическое значение>): пусто Проверяет активацию учётной записи ОС. Данный метод использует асинхронный обратный вызов для возвращения результата.

isOsAccountActived (localId: число): обещание<логическое значение> Проверяет активацию учётной записи ОС. Данный метод использует обещание для возвращения результата.

isOsAccountConstraintEnable (localId: число, ограничение: строка, обратный вызов: AsyncCallback<логическое значение>): пусто Проверяет наличие у учётной записи ОС заданных ограничений. Данный метод использует асинхронный обратный вызов для возвращения результата.

isOsAccountConstraintEnable (localId: число, ограничение: строка): обещание<логическое значение> Проверяет наличие у учётной записи ОС заданных ограничений.

isTestOsAccount (обратный вызов: AsyncCallback<логическое значение>): пусто Проверяет является ли текущая учётная запись ОС тестовой. Данный метод использует асинхронный обратный вызов для возвращения результата.

isTestOsAccount(): обещание<логическое значение> Проверяет является ли текущая учётная запись ОС тестовой. Текст запроса:

name="p686934433810">setOsAccountName(localId: number, localName: string, callback: AsyncCallback<void>): void;

—

Sets a name for an OS account. This method uses an asynchronous callback to return the result.

Перевод:

Устанавливает имя для учётной записи операционной системы (ОС). Этот метод использует асинхронный обратный вызов для возврата результата.

—

Текст запроса:

off(type: 'activate' | 'activating', name: string, callback?: Callback<number>): void;