Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
提交 cf741f35 编写于 作者: C cclicn
浏览文件
操作

【应用帐号】三方应用授权能力相关接口下架 

Signed-off-by: Ncclicn <lichenchen22@huawei.com>
上级 a7a0d9d6
隐藏空白更改
内联 并排
Showing with 129 addition and 379 deletion
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @ cf741f35
......@@ -426,7 +426,6 @@
- 帐号管理
- [@ohos.account.appAccount (应用帐号管理)](js-apis-appAccount.md)
- [@ohos.account.appAccount.AuthorizationExtensionAbility (应用帐号授权扩展能力)](js-apis-appAccount-authorizationExtensionAbility.md)
- [@ohos.account.distributedAccount (分布式帐号管理)](js-apis-distributed-account.md)
- [@ohos.account.osAccount (系统帐号管理)](js-apis-osAccount.md)
......
zh-cn/application-dev/reference/apis/js-apis-appAccount-authorizationExtensionAbility.md 已删除 100644 → 0
浏览文件 @ a7a0d9d6
# @ohos.account.appAccount.AuthorizationExtensionAbility (应用帐号授权扩展能力)
**AuthorizationExtensionAbility**基于ExtensionAbility框架，提供应用帐号授权的能力。
> **说明：**
>
> 本模块首批接口从API version 10开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块
```ts
import AuthorizationExtensionAbility, { AuthorizationRequest, AuthorizationCallback } from '@ohos.account.appAccount.AuthorizationExtensionAbility';
```
## AuthorizationRequest
帐号授权请求信息。
**系统接口：** 此接口为系统接口。
**系统能力：** SystemCapability.Account.AppAccount
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------- | ------------------------------- | ---- | ---- | ------------------------------------ |
| callerUid | number | 是 | 否 | 调用方UID。 |
| parameters | [appAccount.AccountCapabilityRequest](js-apis-appAccount.md#accountcapabilityrequest10) | 是 | 否 | 业务参数。 |
## AuthorizationCallback
帐号授权回调方法类。
**系统接口：** 此接口为系统接口。
**系统能力：** SystemCapability.Account.AppAccount
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------- | ------------------------------- | ---- | ---- | ------------------------------------ |
| onResult | AsyncCallback<[appAccount.AccountCapabilityResponse](js-apis-appAccount.md#accountcapabilityresponse10), { [key: string]: object }> | 是 | 否 | 表示授权结果的回调方法。 |
## AuthorizationExtensionAbility.onStartAuthorization
onStartAuthorization(request: AuthorizationRequest, callback: AuthorizationCallback): void
开始处理授权请求的回调方法。当有新的帐号授权请求到达时，框架会回调此接口。
**系统接口：** 此接口为系统接口。
**系统能力：** SystemCapability.Account.AppAccount
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ----------------------- |
| request | [AuthorizationRequest](#authorizationrequest) | 是 | 授权请求信息。 |
| callback | [AuthorizationCallback](#authorizationcallback) | 是 | 授权回调对象。 |
**示例：**
```ts
import appAccount from '@ohos.account.appAccount';
class MyResponse extends appAccount.AccountCapabilityResponse {
name: string;
scopes: string[];
constructor(request: appAccount.AccountCapabilityRequest) {
super(request);
}
};
class MyAuthorizationExtensionAbility extends AuthorizationExtensionAbility {
onStartAuthorization(request: AuthorizationRequest, callback: AuthorizationCallback) {
console.log('onStartAuthorization, callerUid: ' + request.callerUid + ', parameters: ' + request.parameters);
let response = new MyResponse(null);
response.name = 'xxx';
response.scopes = ['xxx', 'xxx'];
callback.onResult(null, response);
}
};
```
zh-cn/application-dev/reference/apis/js-apis-appAccount.md
浏览文件 @ cf741f35
......@@ -4981,298 +4981,3 @@ getRemoteObject(): rpc.RemoteObject;
}
}
```
## AccountCapabilityType<sup>10+</sup>
表示帐号能力类型枚举。
**系统能力：** SystemCapability.Account.AppAccount
| 名称 | 值 | 说明 |
| ---------------- | ----- | ----------------------- |
| AUTHORIZATION | 1 | 表示授权能力类型。 |
## AccountCapabilityProvider<sup>10+</sup>
帐号能力提供者基类。
### 属性
**系统能力：** SystemCapability.Account.AppAccount
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| capabilityType | [AccountCapabilityType](#accountcapabilitytype10) | 是 | 否 | 表示帐号能力类型。 |
### constructor<sup>10+</sup>
constructor(capabilityType: AccountCapabilityType)
帐号能力提供者基类构造函数。
**系统能力：** SystemCapability.Account.AppAccount
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------- |
| capabilityType | [AccountCapabilityType](#accountcapabilitytype10) | 是 | 表示帐号能力类型。 |
**示例：**
```ts
class MyAuthorizationProvider extends account_appAccount.AccountCapabilityProvider {
constructor() {
super(account_appAccount.AccountCapabilityType.AUTHORIZATION);
}
}
try {
let provider = new MyAuthorizationProvider();
if (provider instanceof account_appAccount.AccountCapabilityProvider) {
console.log("the provider is an instance of AccountCapabilityProvider");
}
} catch (err) {
console.error('catch error: ' + JSON.stringify(err));
}
```
## AccountCapabilityRequest<sup>10+</sup>
帐号能力请求基类。
### constructor<sup>10+</sup>
constructor(provider: AccountCapabilityProvider)
帐号能力请求基类构造函数。
**系统能力：** SystemCapability.Account.AppAccount
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------- |
| provider | [AccountCapabilityProvider](#accountcapabilityprovider10) | 是 | 表示帐号能力的提供者。 |
**示例：**
```ts
class MyAuthorizationProvider extends account_appAccount.AccountCapabilityProvider {
constructor() {
super(account_appAccount.AccountCapabilityType.AUTHORIZATION);
}
}
class MyAuthorizationRequest extends account_appAccount.AccountCapabilityRequest {
constructor() {
let provider = new MyAuthorizationProvider();
super(provider);
}
}
try {
let request = new MyAuthorizationRequest();
if (request instanceof account_appAccount.AccountCapabilityRequest) {
console.log("the request is an instance of AccountCapabilityRequest");
}
} catch (err) {
console.error('catch error: ' + JSON.stringify(err));
}
```
## AccountCapabilityResponse<sup>10+</sup>
帐号能力响应基类。
### 属性
**系统能力：** SystemCapability.Account.AppAccount
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| request | [AccountCapabilityRequest](#accountcapabilityrequest10) | 是 | 否 | 表示此响应对应的帐号能力请求。 |
### constructor<sup>10+</sup>
constructor(request: AccountCapabilityRequest)
帐号能力响应基类构造函数。
**系统能力：** SystemCapability.Account.AppAccount
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------- |
| request | [AccountCapabilityRequest](#accountcapabilityrequest10) | 是 | 表示此响应对应的帐号能力请求。 |
**示例：**
```ts
class MyAuthorizationProvider extends account_appAccount.AccountCapabilityProvider {
constructor() {
super(account_appAccount.AccountCapabilityType.AUTHORIZATION);
}
}
class MyAuthorizationRequest extends account_appAccount.AccountCapabilityRequest {
constructor() {
let provider = new MyAuthorizationProvider();
super(provider);
}
}
class MyAuthorizationResponse extends account_appAccount.AccountCapabilityResponse {
constructor(request) {
super(request)
}
}
try {
let request = new MyAuthorizationRequest();
let response = new MyAuthorizationResponse(request);
if (response instanceof account_appAccount.AccountCapabilityResponse) {
console.log("the response is an instance of AccountCapabilityResponse");
}
} catch (err) {
console.error('catch error: ' + JSON.stringify(err));
}
```
## AuthorizationProviderInfo<sup>10+</sup>
表示帐号授权能力提供者信息。
**系统能力：** SystemCapability.Account.AppAccount
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------- | ------ | ---- | --- | ---------- |
| bundleName | string | 是 | 否 | 授权能力提供者的Bundle名。 |
| abilityName | string | 是 | 否 | 授权能力提供者的Ability名。 |
## AuthorizationProvider<sup>10+</sup>
帐号授权能力提供者类。
### constructor<sup>10+</sup>
constructor(info: AuthorizationProviderInfo)
帐号授权能力提供者类构造函数。
**系统能力：** SystemCapability.Account.AppAccount
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------- |
| info | [AuthorizationProviderInfo](#authorizationproviderinfo10) | 是 | 表示帐号能力提供者的信息。 |
**示例：**
```ts
class MyAuthorizationProvider extends account_appAccount.AuthorizationProvider {
constructor() {
super({bundleName: 'xxx', abilityName: 'xxx'});
}
}
try {
let provider = new MyAuthorizationProvider();
if (provider instanceof account_appAccount.AuthorizationProvider) {
console.log("the provider is an instance of AuthorizationProvider");
}
} catch (err) {
console.error("catch error: " + JSON.stringify(err));
}
```
## AccountCapabilityScheduler<sup>10+</sup>
帐号能力调度器类。
### executeRequest<sup>10+</sup>
executeRequest(request: AccountCapabilityRequest, callback: AsyncCallback&lt;AccountCapabilityResponse, { [key: string]: object }&gt;): void
执行帐号能力请求。使用callback异步回调。
**系统能力：** SystemCapability.Account.AppAccount
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------- | ---- | ------------------------- |
| request | [AccountCapabilityRequest](#accountcapabilityrequest10) | 是 | 表示帐号能力请求。 |
| callback | AsyncCallback&lt;[AccountCapabilityResponse](#accountcapabilityresponse10), { [key: string]: object }&gt; | 是 | 表示请求的回调方法。当执行成功时，err为null；否则为错误对象。 |
**错误码：**
| 错误码ID | 错误信息 |
| ------- | ------- |
| 12300001 | System service exception. |
| 12300002 | Invalid request. |
**示例：**
```ts
let scheduler = new account_appAccount.AccountCapabilityScheduler();
let provider = new account_appAccount.AuthorizationProvider({ bundleName: 'xxx', abilityName: 'xxx' });
let request = new account_appAccount.AccountCapabilityRequest(provider);
try {
scheduler.executeRequest(request, (err, response) => {
if (err != null) {
console.log('executeRequest failed, error: ' + JSON.stringify(err));
} else {
console.log('executeRequest response: ' + JSON.stringify(response));
}
});
} catch (err) {
console.log('executeRequest exception: ' + JSON.stringify(err));
}
```
### executeRequest<sup>10+</sup>
executeRequest(request: AccountCapabilityRequest): Promise&lt;AccountCapabilityResponse&gt;
执行帐号能力请求。使用Promise异步回调。
**系统能力：** SystemCapability.Account.AppAccount
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------- | ---- | ------------ |
| request | [AccountCapabilityRequest](#accountcapabilityrequest10) | 是 | 表示帐号能力请求。 |
**返回值：**
| 类型 | 说明 |
| ------------------- | --------------------- |
| Promise&lt;[AccountCapabilityResponse](#accountcapabilityresponse10)&gt; | Promise对象，返回请求执行的响应结果。 |
**错误码：**
| 错误码ID | 错误信息 |
| ------- | ------- |
| 12300001 | System service exception. |
| 12300002 | Invalid request. |
**示例：**
```ts
let scheduler = new account_appAccount.AccountCapabilityScheduler();
let provider = new account_appAccount.AuthorizationProvider({ bundleName: 'xxx', abilityName: 'xxx' });
let request = new account_appAccount.AccountCapabilityRequest(provider);
try {
scheduler.executeRequest(request).then((response) => {
console.log('executeRequest response: ' + JSON.stringify(response));
}).catch((err) => {
console.log('executeRequest failed, error: ' + JSON.stringify(err));
});
} catch (err) {
console.log('executeRequest exception: ' + JSON.stringify(err));
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundleManager.md
浏览文件 @ cf741f35
......@@ -99,7 +99,7 @@ Ability组件信息标志，指示需要获取的Ability组件信息的内容。
| 名称 | 值 | 说明 |
|:----------------:|:---:|-----|
| FORM | 0 | [FormExtensionAbility](../../application-models/service-widget-overview.md)：卡片扩展能力，提供卡片开发能力。 |
| WORK_SCHEDULER | 1 | [WorkSchedulerExtensionAbility](../../task-management/work-scheduler-dev-guide.md)：延时任务扩展能力，允许应用在系统闲时执行实时性不高的任务。 |
| WORK_SCHEDULER | 1 | [WorkSchedulerExtensionAbility](../../task-management/work-scheduler.md)：延时任务扩展能力，允许应用在系统闲时执行实时性不高的任务。 |
| INPUT_METHOD | 2 | [InputMethodExtensionAbility](js-apis-inputmethod-extension-ability.md)：输入法扩展能力，用于开发输入法应用。 |
| SERVICE | 3 | [ServiceExtensionAbility](../../application-models/serviceextensionability.md)：后台服务扩展能力，提供后台运行并对外提供相应能力。 |
| ACCESSIBILITY | 4 | [AccessibilityExtensionAbility](js-apis-application-accessibilityExtensionAbility.md)：无障碍服务扩展能力，支持访问与操作前台界面。 |
......@@ -115,7 +115,6 @@ Ability组件信息标志，指示需要获取的Ability组件信息的内容。
| PRINT<sup>10+</sup> | 15 | PrintExtensionAbility：文件打印扩展能力，提供应用打印照片、文档等办公场景。当前支持图片打印，文档类型暂未支持。 |
| PUSH<sup>10+</sup> | 17 | PushExtensionAbility：推送扩展能力，提供推送场景化消息能力。预留能力，当前暂未支持。 |
| DRIVER<sup>10+</sup> | 18 | DriverExtensionAbility：驱动扩展能力，提供外设驱动扩展能力，当前暂未支持。 |
| APP_ACCOUNT_AUTHORIZATION<sup>10+</sup> | 19 | [AuthorizationExtensionAbility](js-apis-appAccount-authorizationExtensionAbility.md)：应用帐号认证扩展能力，用于处理帐号授权的请求，允许第三方（相对于操作系统厂商）生态平台的帐号授权。 |
| UNSPECIFIED | 255 | 不指定类型，配合queryExtensionAbilityInfo接口可以查询所有类型的ExtensionAbility。 |
......
zh-cn/application-dev/website.md
浏览文件 @ cf741f35
......@@ -1161,7 +1161,6 @@
- [DriverExtensionContext](reference/apis/js-apis-inner-application-driverExtensionContext.md)
- 帐号管理
- [@ohos.account.appAccount (应用帐号管理)](reference/apis/js-apis-appAccount.md)
- [@ohos.account.appAccount.AuthorizationExtensionAbility (应用帐号授权扩展能力)](reference/apis/js-apis-appAccount-authorizationExtensionAbility.md)
- [@ohos.account.distributedAccount (分布式帐号管理)](reference/apis/js-apis-distributed-account.md)
- [@ohos.account.osAccount (系统帐号管理)](reference/apis/js-apis-osAccount.md)
- 定制管理
......
zh-cn/release-notes/changelogs/OpenHarmony_4.0.10.1/changelogs-account_os_account.md 0 → 100644
浏览文件 @ cf741f35
# 帐号子系统ChangeLog
## cl.account_os_account.1 删除应用帐号授权接口
**变更影响**
基于此前版本开发的应用，无法继续使用帐号授权能力。
**关键接口/组件变更**
涉及接口：
interface/sdk-js/api/@ohos.account.appAccount.d.ts:
```js
enum AccountCapabilityType
```
```js
class AccountCapabilityProvider
```
```js
class AuthorizationProvider extends AccountCapabilityProvider
```
```js
interface AuthorizationProviderInfo
```
```js
class AccountCapabilityRequest
```
```js
class AccountCapabilityResponse
```
```js
class AccountCapabilityScheduler
```
interface/sdk-js/api/@ohos.account.appAccount.AuthorizationExtensionAbility.d.ts:
```js
export default class AuthorizationExtensionAbility extends ExtensionAbility
```
```js
declare interface AuthorizationRequest
```
```js
declare interface AuthorizationCallback
```
变更后：
涉及接口全部删除。
**适配指导**
该接口删除后无法再使用，请同步删除相应功能。
\ No newline at end of file
zh-cn/release-notes/changelogs/OpenHarmony_4.0.10.1/changelogs-bundlemanager.md 0 → 100644
浏览文件 @ cf741f35
# 包管理子系统ChangeLog
## cl.bundlemanager.1 ExtensionAbilityType定义变更，删除APP_ACCOUNT_AUTHORIZATION
从当前版本开始，删除此枚举类型中的APP_ACCOUNT_AUTHORIZATION。
开发者需要根据以下说明对应用进行适配。
**变更影响**
该接口删除无法再使用，请进行适配更新，否则会影响原有功能。
- 涉及接口
```js
export enum ExtensionAbilityType
```
- 变更前：
```js
export enum ExtensionAbilityType {
FORM = 0,
WORK_SCHEDULER = 1,
INPUT_METHOD = 2,
SERVICE = 3,
ACCESSIBILITY = 4,
DATA_SHARE = 5,
FILE_SHARE = 6,
STATIC_SUBSCRIBER = 7,
WALLPAPER = 8,
BACKUP = 9,
WINDOW = 10,
ENTERPRISE_ADMIN = 11,
THUMBNAIL = 13,
PREVIEW = 14,
PRINT = 15,
PUSH = 17,
DRIVER = 18,
APP_ACCOUNT_AUTHORIZATION = 19,
UNSPECIFIED = 255
}
```
- 变更后：
```js
export enum ExtensionAbilityType {
FORM = 0,
WORK_SCHEDULER = 1,
INPUT_METHOD = 2,
SERVICE = 3,
ACCESSIBILITY = 4,
DATA_SHARE = 5,
FILE_SHARE = 6,
STATIC_SUBSCRIBER = 7,
WALLPAPER = 8,
BACKUP = 9,
WINDOW = 10,
ENTERPRISE_ADMIN = 11,
THUMBNAIL = 13,
PREVIEW = 14,
PRINT = 15,
PUSH = 17,
DRIVER = 18,
UNSPECIFIED = 255
}
```
删除APP_ACCOUNT_AUTHORIZATION定义。
**适配指导**
该接口删除后无法再使用，请适配更新。
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或