Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 ba1a731a 编写于 作者: D donglin
浏览文件
操作

merge 

Signed-off-by: Ndonglin <donglin9@huawei.com>
Change-Id: Ib0363b5f11dcfd4c083e1b6892fd233757154d8d
上级 7f821a59 0612bb09
展开全部 隐藏空白更改
内联 并排
Showing with 10748 addition and 6986 deletion
en/application-dev/reference/apis/js-apis-continuation-continuationManager.md
浏览文件 @ ba1a731a
...@@ -32,7 +32,7 @@ Registers the continuation management service and obtains a token. This API does ...@@ -32,7 +32,7 @@ Registers the continuation management service and obtains a token. This API does
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -73,7 +73,7 @@ Registers the continuation management service and obtains a token. This API uses ...@@ -73,7 +73,7 @@ Registers the continuation management service and obtains a token. This API uses
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -123,7 +123,7 @@ Registers the continuation management service and obtains a token. This API uses ...@@ -123,7 +123,7 @@ Registers the continuation management service and obtains a token. This API uses
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -167,7 +167,7 @@ Registers the continuation management service and obtains a token. This API does ...@@ -167,7 +167,7 @@ Registers the continuation management service and obtains a token. This API does
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -212,7 +212,7 @@ Registers the continuation management service and obtains a token. This API uses ...@@ -212,7 +212,7 @@ Registers the continuation management service and obtains a token. This API uses
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -265,7 +265,7 @@ Registers the continuation management service and obtains a token. This API uses ...@@ -265,7 +265,7 @@ Registers the continuation management service and obtains a token. This API uses
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -314,7 +314,7 @@ Subscribes to device connection events. This API uses an asynchronous callback t ...@@ -314,7 +314,7 @@ Subscribes to device connection events. This API uses an asynchronous callback t
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -353,7 +353,7 @@ Subscribes to device disconnection events. This API uses an asynchronous callbac ...@@ -353,7 +353,7 @@ Subscribes to device disconnection events. This API uses an asynchronous callbac
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -390,7 +390,7 @@ Unsubscribes from device connection events. This API uses an asynchronous callba ...@@ -390,7 +390,7 @@ Unsubscribes from device connection events. This API uses an asynchronous callba
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -429,7 +429,7 @@ Unsubscribes from device disconnection events. This API uses an asynchronous cal ...@@ -429,7 +429,7 @@ Unsubscribes from device disconnection events. This API uses an asynchronous cal
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -467,7 +467,7 @@ Subscribes to device connection events. This API uses an asynchronous callback t ...@@ -467,7 +467,7 @@ Subscribes to device connection events. This API uses an asynchronous callback t
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -514,7 +514,7 @@ Subscribes to device disconnection events. This API uses an asynchronous callbac ...@@ -514,7 +514,7 @@ Subscribes to device disconnection events. This API uses an asynchronous callbac
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -561,7 +561,7 @@ Unsubscribes from device connection events. ...@@ -561,7 +561,7 @@ Unsubscribes from device connection events.
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -600,7 +600,7 @@ Unsubscribes from device disconnection events. ...@@ -600,7 +600,7 @@ Unsubscribes from device disconnection events.
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -639,7 +639,7 @@ Starts the device selection module to show the list of available devices on the ...@@ -639,7 +639,7 @@ Starts the device selection module to show the list of available devices on the
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -683,7 +683,7 @@ Starts the device selection module to show the list of available devices on the ...@@ -683,7 +683,7 @@ Starts the device selection module to show the list of available devices on the
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -735,7 +735,7 @@ Starts the device selection module to show the list of available devices on the ...@@ -735,7 +735,7 @@ Starts the device selection module to show the list of available devices on the
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -781,7 +781,7 @@ Starts the device selection module to show the list of available devices on the ...@@ -781,7 +781,7 @@ Starts the device selection module to show the list of available devices on the
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -826,7 +826,7 @@ Starts the device selection module to show the list of available devices on the ...@@ -826,7 +826,7 @@ Starts the device selection module to show the list of available devices on the
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -879,7 +879,7 @@ Starts the device selection module to show the list of available devices on the ...@@ -879,7 +879,7 @@ Starts the device selection module to show the list of available devices on the
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -928,7 +928,7 @@ Instructs the device selection module to update the device connection state. Thi ...@@ -928,7 +928,7 @@ Instructs the device selection module to update the device connection state. Thi
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -979,7 +979,7 @@ Instructs the device selection module to update the device connection state. Thi ...@@ -979,7 +979,7 @@ Instructs the device selection module to update the device connection state. Thi
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -1025,7 +1025,7 @@ Instructs the device selection module to update the device connection state. Thi ...@@ -1025,7 +1025,7 @@ Instructs the device selection module to update the device connection state. Thi
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -1077,7 +1077,7 @@ Instructs the device selection module to update the device connection state. Thi ...@@ -1077,7 +1077,7 @@ Instructs the device selection module to update the device connection state. Thi
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -1123,7 +1123,7 @@ Deregisters the continuation management service. This API uses an asynchronous c ...@@ -1123,7 +1123,7 @@ Deregisters the continuation management service. This API uses an asynchronous c
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -1168,7 +1168,7 @@ Deregisters the continuation management service. This API uses a promise to retu ...@@ -1168,7 +1168,7 @@ Deregisters the continuation management service. This API uses a promise to retu
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -1208,7 +1208,7 @@ Deregisters the continuation management service. This API uses an asynchronous c ...@@ -1208,7 +1208,7 @@ Deregisters the continuation management service. This API uses an asynchronous c
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
...@@ -1257,7 +1257,7 @@ Deregisters the continuation management service. This API uses a promise to retu ...@@ -1257,7 +1257,7 @@ Deregisters the continuation management service. This API uses a promise to retu
**Error codes** **Error codes**
For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errcode-DistributedSchedule.md). For details about the error codes, see [Distributed Scheduler Error Codes](../errorcodes/errorcode-DistributedSchedule.md).
| ID| Error Message| | ID| Error Message|
| ------- | -------------------------------------------- | | ------- | -------------------------------------------- |
......
en/application-dev/reference/apis/js-apis-cooperate.md
浏览文件 @ ba1a731a
...@@ -102,7 +102,7 @@ Starts screen hopping. This API uses an asynchronous callback to return the resu ...@@ -102,7 +102,7 @@ Starts screen hopping. This API uses an asynchronous callback to return the resu
**Error codes** **Error codes**
For details about the error codes, see [Screen Hopping Error Codes](../errorcodes/errorcodes-multimodalinput.md). For details about the error codes, see [Screen Hopping Error Codes](../errorcodes/errorcode-multimodalinput.md).
| ID| Error Message| | ID| Error Message|
| -------- | ---------------------------------------- | | -------- | ---------------------------------------- |
...@@ -150,7 +150,7 @@ Starts screen hopping. This API uses a promise to return the result. ...@@ -150,7 +150,7 @@ Starts screen hopping. This API uses a promise to return the result.
**Error codes** **Error codes**
For details about the error codes, see [Screen Hopping Error Codes](../errorcodes/errorcodes-multimodalinput.md). For details about the error codes, see [Screen Hopping Error Codes](../errorcodes/errorcode-multimodalinput.md).
| ID| Error Message| | ID| Error Message|
| -------- | ---------------------------------------- | | -------- | ---------------------------------------- |
......
en/application-dev/reference/apis/js-apis-url.md
浏览文件 @ ba1a731a
...@@ -713,9 +713,11 @@ for (var value of searchParams.values()) { ...@@ -713,9 +713,11 @@ for (var value of searchParams.values()) {
### [Symbol.iterator]<sup>(deprecated)</sup> ### [Symbol.iterator]<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
> This API is deprecated since API version 9. You are advised to use [URLParams<sup>9+</sup>.[Symbol.iterator]<sup>9+</sup>](#symbol.iterator9) instead. > This API is deprecated since API version 9. You are advised to use [[Symbol.iterator]<sup>9+</sup>](#symboliterator9) instead.
[Symbol.iterator]\(): IterableIterator&lt;[string, string]&gt; [Symbol.iterator]\(): IterableIterator&lt;[string, string]&gt;
......
en/application-dev/reference/apis/js-apis-util.md
浏览文件 @ ba1a731a
...@@ -661,7 +661,7 @@ let rationalNumber = new util.RationalNumber(); ...@@ -661,7 +661,7 @@ let rationalNumber = new util.RationalNumber();
rationalNumber.parseRationalNumber(1,2) rationalNumber.parseRationalNumber(1,2)
``` ```
### constructor<sup>8+(deprecated)</sup> ### constructor<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -846,7 +846,7 @@ let rationalNumber = new util.RationalNumber(1,2); ...@@ -846,7 +846,7 @@ let rationalNumber = new util.RationalNumber(1,2);
let result = util.RationalNumber.getCommonFactor(4,6); let result = util.RationalNumber.getCommonFactor(4,6);
``` ```
### getCommonDivisor<sup>8+(deprecated)</sup> ### getCommonDivisor<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
> This API is deprecated since API version 9. You are advised to use [getCommonFactor9+](#getcommonfactor9) instead. > This API is deprecated since API version 9. You are advised to use [getCommonFactor9+](#getcommonfactor9) instead.
...@@ -1541,7 +1541,7 @@ pro.put(2,10); ...@@ -1541,7 +1541,7 @@ pro.put(2,10);
let result = pro[Symbol.iterator](); let result = pro[Symbol.iterator]();
``` ```
## LruBuffer<sup>8+(deprecated)</sup> ## LruBuffer<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1563,7 +1563,7 @@ let result = pro[Symbol.iterator](); ...@@ -1563,7 +1563,7 @@ let result = pro[Symbol.iterator]();
let result = pro.length; let result = pro.length;
``` ```
### constructor<sup>8+(deprecated)</sup> ### constructor<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1586,7 +1586,7 @@ A constructor used to create a **LruBuffer** instance. The default capacity of t ...@@ -1586,7 +1586,7 @@ A constructor used to create a **LruBuffer** instance. The default capacity of t
let lrubuffer= new util.LruBuffer(); let lrubuffer= new util.LruBuffer();
``` ```
### updateCapacity<sup>8+(deprecated)</sup> ### updateCapacity<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1610,7 +1610,7 @@ Changes the **LruBuffer** capacity. If the new capacity is less than or equal to ...@@ -1610,7 +1610,7 @@ Changes the **LruBuffer** capacity. If the new capacity is less than or equal to
let result = pro.updateCapacity(100); let result = pro.updateCapacity(100);
``` ```
### toString<sup>8+(deprecated)</sup> ### toString<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1637,7 +1637,7 @@ Obtains the string representation of this **LruBuffer** object. ...@@ -1637,7 +1637,7 @@ Obtains the string representation of this **LruBuffer** object.
let result = pro.toString(); let result = pro.toString();
``` ```
### getCapacity<sup>8+(deprecated)</sup> ### getCapacity<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1661,7 +1661,7 @@ Obtains the capacity of this buffer. ...@@ -1661,7 +1661,7 @@ Obtains the capacity of this buffer.
let result = pro.getCapacity(); let result = pro.getCapacity();
``` ```
### clear<sup>8+(deprecated)</sup> ### clear<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1681,7 +1681,7 @@ Clears key-value pairs from this buffer. The **afterRemoval()** method will be c ...@@ -1681,7 +1681,7 @@ Clears key-value pairs from this buffer. The **afterRemoval()** method will be c
pro.clear(); pro.clear();
``` ```
### getCreateCount<sup>8+(deprecated)</sup> ### getCreateCount<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1706,7 +1706,7 @@ Obtains the number of return values for **createDefault()**. ...@@ -1706,7 +1706,7 @@ Obtains the number of return values for **createDefault()**.
let result = pro.getCreateCount(); let result = pro.getCreateCount();
``` ```
### getMissCount<sup>8+(deprecated)</sup> ### getMissCount<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1732,7 +1732,7 @@ Obtains the number of times that the queried values are mismatched. ...@@ -1732,7 +1732,7 @@ Obtains the number of times that the queried values are mismatched.
let result = pro.getMissCount(); let result = pro.getMissCount();
``` ```
### getRemovalCount<sup>8+(deprecated)</sup> ### getRemovalCount<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1759,7 +1759,7 @@ Obtains the number of removals from this buffer. ...@@ -1759,7 +1759,7 @@ Obtains the number of removals from this buffer.
let result = pro.getRemovalCount(); let result = pro.getRemovalCount();
``` ```
### getMatchCount<sup>8+(deprecated)</sup> ### getMatchCount<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1785,7 +1785,7 @@ Obtains the number of times that the queried values are matched. ...@@ -1785,7 +1785,7 @@ Obtains the number of times that the queried values are matched.
let result = pro.getMatchCount(); let result = pro.getMatchCount();
``` ```
### getPutCount<sup>8+(deprecated)</sup> ### getPutCount<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1810,7 +1810,7 @@ Obtains the number of additions to this buffer. ...@@ -1810,7 +1810,7 @@ Obtains the number of additions to this buffer.
let result = pro.getPutCount(); let result = pro.getPutCount();
``` ```
### isEmpty<sup>8+(deprecated)</sup> ### isEmpty<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1835,7 +1835,7 @@ Checks whether this buffer is empty. ...@@ -1835,7 +1835,7 @@ Checks whether this buffer is empty.
let result = pro.isEmpty(); let result = pro.isEmpty();
``` ```
### get<sup>8+(deprecated)</sup> ### get<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1866,7 +1866,7 @@ Obtains the value of the specified key. ...@@ -1866,7 +1866,7 @@ Obtains the value of the specified key.
let result = pro.get(2); let result = pro.get(2);
``` ```
### put<sup>8+(deprecated)</sup> ### put<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1897,7 +1897,7 @@ Adds a key-value pair to this buffer. ...@@ -1897,7 +1897,7 @@ Adds a key-value pair to this buffer.
let result = pro.put(2,10); let result = pro.put(2,10);
``` ```
### values<sup>8+(deprecated)</sup> ### values<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1924,7 +1924,7 @@ Obtains all values in this buffer, listed from the most to the least recently ac ...@@ -1924,7 +1924,7 @@ Obtains all values in this buffer, listed from the most to the least recently ac
let result = pro.values(); let result = pro.values();
``` ```
### keys<sup>8+(deprecated)</sup> ### keys<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1949,7 +1949,7 @@ Obtains all keys in this buffer, listed from the most to the least recently acce ...@@ -1949,7 +1949,7 @@ Obtains all keys in this buffer, listed from the most to the least recently acce
let result = pro.keys(); let result = pro.keys();
``` ```
### remove<sup>8+(deprecated)</sup> ### remove<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -1980,7 +1980,7 @@ Removes the specified key and its value from this buffer. ...@@ -1980,7 +1980,7 @@ Removes the specified key and its value from this buffer.
let result = pro.remove(20); let result = pro.remove(20);
``` ```
### afterRemoval<sup>8+(deprecated)</sup> ### afterRemoval<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2022,7 +2022,7 @@ Performs subsequent operations after a value is removed. ...@@ -2022,7 +2022,7 @@ Performs subsequent operations after a value is removed.
lru.afterRemoval(false,10,30,null); lru.afterRemoval(false,10,30,null);
``` ```
### contains<sup>8+(deprecated)</sup> ### contains<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2053,7 +2053,7 @@ Checks whether this buffer contains the specified key. ...@@ -2053,7 +2053,7 @@ Checks whether this buffer contains the specified key.
let result = pro.contains(20); let result = pro.contains(20);
``` ```
### createDefault<sup>8+(deprecated)</sup> ### createDefault<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2083,7 +2083,7 @@ Creates a value if the value of the specified key is not available. ...@@ -2083,7 +2083,7 @@ Creates a value if the value of the specified key is not available.
let result = pro.createDefault(50); let result = pro.createDefault(50);
``` ```
### entries<sup>8+(deprecated)</sup> ### entries<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2108,11 +2108,11 @@ Obtains a new iterator object that contains all key-value pairs in this object. ...@@ -2108,11 +2108,11 @@ Obtains a new iterator object that contains all key-value pairs in this object.
let result = pro.entries(); let result = pro.entries();
``` ```
### [Symbol.iterator]<sup>8+(deprecated)</sup> ### [Symbol.iterator]<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
> This API is deprecated since API version 9. You are advised to use [Symbol.iterator9+](#symboliterator9) instead. > This API is deprecated since API version 9. You are advised to use [Symbol.iterator<sup>9+</sup>](#symboliterator9) instead.
[Symbol.iterator]\(): IterableIterator&lt;[K, V]&gt; [Symbol.iterator]\(): IterableIterator&lt;[K, V]&gt;
...@@ -2524,13 +2524,13 @@ let range = new util.ScopeHelper(tempLower, tempUpper); ...@@ -2524,13 +2524,13 @@ let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.clamp(tempMiDF); let result = range.clamp(tempMiDF);
``` ```
## Scope<sup>8+(deprecated)</sup> ## Scope<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
> This class is deprecated since API version 9. You are advised to use [ScopeHelper9+](#scopehelper9) instead. > This class is deprecated since API version 9. You are advised to use [ScopeHelper9+](#scopehelper9) instead.
### constructor<sup>8+(deprecated)</sup> ### constructor<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2556,7 +2556,7 @@ A constructor used to create a **Scope** object with the specified upper and low ...@@ -2556,7 +2556,7 @@ A constructor used to create a **Scope** object with the specified upper and low
let range = new util.Scope(tempLower, tempUpper); let range = new util.Scope(tempLower, tempUpper);
``` ```
### toString<sup>8+(deprecated)</sup> ### toString<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2582,7 +2582,7 @@ Obtains a string representation that contains this **Scope**. ...@@ -2582,7 +2582,7 @@ Obtains a string representation that contains this **Scope**.
let result = range.toString(); let result = range.toString();
``` ```
### intersect<sup>8+(deprecated)</sup> ### intersect<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2598,13 +2598,13 @@ Obtains the intersection of this **Scope** and the given **Scope**. ...@@ -2598,13 +2598,13 @@ Obtains the intersection of this **Scope** and the given **Scope**.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| range | [Scope](#scope8) | Yes| **Scope** specified.| | range | [Scope](#scopedeprecated) | Yes| **Scope** specified.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [Scope](#scope8) | Intersection of this **Scope** and the given **Scope**.| | [Scope](#scopedeprecated) | Intersection of this **Scope** and the given **Scope**.|
**Example** **Example**
...@@ -2618,7 +2618,7 @@ Obtains the intersection of this **Scope** and the given **Scope**. ...@@ -2618,7 +2618,7 @@ Obtains the intersection of this **Scope** and the given **Scope**.
range.intersect(rangeFir ); range.intersect(rangeFir );
``` ```
### intersect<sup>8+(deprecated)</sup> ### intersect<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2641,7 +2641,7 @@ Obtains the intersection of this **Scope** and the given lower and upper limits. ...@@ -2641,7 +2641,7 @@ Obtains the intersection of this **Scope** and the given lower and upper limits.
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [Scope](#scope8) | Intersection of this **Scope** and the given lower and upper limits.| | [Scope](#scopedeprecated) | Intersection of this **Scope** and the given lower and upper limits.|
**Example** **Example**
```js ```js
...@@ -2653,7 +2653,7 @@ Obtains the intersection of this **Scope** and the given lower and upper limits. ...@@ -2653,7 +2653,7 @@ Obtains the intersection of this **Scope** and the given lower and upper limits.
let result = range.intersect(tempMiDF, tempMidS); let result = range.intersect(tempMiDF, tempMidS);
``` ```
### getUpper<sup>8+(deprecated)</sup> ### getUpper<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2679,7 +2679,7 @@ Obtains the upper limit of this **Scope**. ...@@ -2679,7 +2679,7 @@ Obtains the upper limit of this **Scope**.
let result = range.getUpper(); let result = range.getUpper();
``` ```
### getLower<sup>8+(deprecated)</sup> ### getLower<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2705,7 +2705,7 @@ Obtains the lower limit of this **Scope**. ...@@ -2705,7 +2705,7 @@ Obtains the lower limit of this **Scope**.
let result = range.getLower(); let result = range.getLower();
``` ```
### expand<sup>8+(deprecated)</sup> ### expand<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2728,7 +2728,7 @@ Obtains the union set of this **Scope** and the given lower and upper limits. ...@@ -2728,7 +2728,7 @@ Obtains the union set of this **Scope** and the given lower and upper limits.
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [Scope](#scope8) | Union set of this **Scope** and the given lower and upper limits.| | [Scope](#scopedeprecated) | Union set of this **Scope** and the given lower and upper limits.|
**Example** **Example**
...@@ -2741,7 +2741,7 @@ Obtains the union set of this **Scope** and the given lower and upper limits. ...@@ -2741,7 +2741,7 @@ Obtains the union set of this **Scope** and the given lower and upper limits.
let result = range.expand(tempMiDF, tempMidS); let result = range.expand(tempMiDF, tempMidS);
``` ```
### expand<sup>8+(deprecated)</sup> ### expand<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2757,13 +2757,13 @@ Obtains the union set of this **Scope** and the given **Scope**. ...@@ -2757,13 +2757,13 @@ Obtains the union set of this **Scope** and the given **Scope**.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| range | [Scope](#scope8) | Yes| **Scope** specified.| | range | [Scope](#scopedeprecated) | Yes| **Scope** specified.|
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [Scope](#scope8) | Union set of this **Scope** and the given **Scope**.| | [Scope](#scopedeprecated) | Union set of this **Scope** and the given **Scope**.|
**Example** **Example**
```js ```js
...@@ -2776,7 +2776,7 @@ Obtains the union set of this **Scope** and the given **Scope**. ...@@ -2776,7 +2776,7 @@ Obtains the union set of this **Scope** and the given **Scope**.
let result = range.expand(rangeFir); let result = range.expand(rangeFir);
``` ```
### expand<sup>8+(deprecated)</sup> ### expand<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2798,7 +2798,7 @@ Obtains the union set of this **Scope** and the given value. ...@@ -2798,7 +2798,7 @@ Obtains the union set of this **Scope** and the given value.
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| [Scope](#scope8) | Union set of this **Scope** and the given value.| | [Scope](#scopedeprecated) | Union set of this **Scope** and the given value.|
**Example** **Example**
```js ```js
...@@ -2809,7 +2809,7 @@ Obtains the union set of this **Scope** and the given value. ...@@ -2809,7 +2809,7 @@ Obtains the union set of this **Scope** and the given value.
let result = range.expand(tempMiDF); let result = range.expand(tempMiDF);
``` ```
### contains<sup>8+(deprecated)</sup> ### contains<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2842,7 +2842,7 @@ Checks whether a value is within this **Scope**. ...@@ -2842,7 +2842,7 @@ Checks whether a value is within this **Scope**.
range.contains(tempMiDF); range.contains(tempMiDF);
``` ```
### contains<sup>8+(deprecated)</sup> ### contains<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -2858,7 +2858,7 @@ Checks whether a range is within this **Scope**. ...@@ -2858,7 +2858,7 @@ Checks whether a range is within this **Scope**.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| range | [Scope](#scope8) | Yes| **Scope** specified.| | range | [Scope](#scopedeprecated) | Yes| **Scope** specified.|
**Return value** **Return value**
...@@ -2878,7 +2878,7 @@ Checks whether a range is within this **Scope**. ...@@ -2878,7 +2878,7 @@ Checks whether a range is within this **Scope**.
let result = range.contains(rangeSec); let result = range.contains(rangeSec);
``` ```
### clamp<sup>8+(deprecated)</sup> ### clamp<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -3113,13 +3113,13 @@ that.decode(array).then(val=>{ ...@@ -3113,13 +3113,13 @@ that.decode(array).then(val=>{
``` ```
## Base64<sup>8+(deprecated)</sup> ## Base64<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
> This class is deprecated since API version 9. You are advised to use [Base64Helper9+](#base64helper9) instead. > This class is deprecated since API version 9. You are advised to use [Base64Helper9+](#base64helper9) instead.
### constructor<sup>8+(deprecated)</sup> ### constructor<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -3136,7 +3136,7 @@ A constructor used to create a **Base64** object. ...@@ -3136,7 +3136,7 @@ A constructor used to create a **Base64** object.
let base64 = new util.Base64(); let base64 = new util.Base64();
``` ```
### encodeSync<sup>8+(deprecated)</sup> ### encodeSync<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -3168,7 +3168,7 @@ Encodes the input content. ...@@ -3168,7 +3168,7 @@ Encodes the input content.
let result = that.encodeSync(array); let result = that.encodeSync(array);
``` ```
### encodeToStringSync<sup>8+(deprecated)</sup> ### encodeToStringSync<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -3199,7 +3199,7 @@ Encodes the input content. ...@@ -3199,7 +3199,7 @@ Encodes the input content.
let result = that.encodeToStringSync(array); let result = that.encodeToStringSync(array);
``` ```
### decodeSync<sup>8+(deprecated)</sup> ### decodeSync<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -3230,7 +3230,7 @@ Decodes the input content. ...@@ -3230,7 +3230,7 @@ Decodes the input content.
let result = that.decodeSync(buff); let result = that.decodeSync(buff);
``` ```
### encode<sup>8+(deprecated)</sup> ### encode<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -3266,7 +3266,7 @@ Encodes the input content asynchronously. ...@@ -3266,7 +3266,7 @@ Encodes the input content asynchronously.
}) })
``` ```
### encodeToString<sup>8+(deprecated)</sup> ### encodeToString<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
...@@ -3299,7 +3299,7 @@ Encodes the input content asynchronously. ...@@ -3299,7 +3299,7 @@ Encodes the input content asynchronously.
}) })
``` ```
### decode<sup>8+(deprecated)</sup> ### decode<sup>(deprecated)</sup>
> **NOTE** > **NOTE**
> >
......
en/application-dev/reference/arkui-js/js-components-svg.md
浏览文件 @ ba1a731a
...@@ -4,9 +4,9 @@ The **\<svg>** component is a basic container. It can be used as the root node o ...@@ -4,9 +4,9 @@ The **\<svg>** component is a basic container. It can be used as the root node o
> **NOTE** > **NOTE**
> - This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version. > - This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
> >
> - The width and height must be defined for the **\<svg>** parent component or **\<svg>** component. Otherwise, the component is not drawn. > - The width and height must be defined for the **\<svg>** parent component or **\<svg>** component. Otherwise, the component is not drawn.
## Required Permissions ## Required Permissions
...@@ -15,21 +15,21 @@ None ...@@ -15,21 +15,21 @@ None
## Child Components ## Child Components
The following are supported: [\<svg>](js-components-svg.md), [\<rect>](js-components-svg-rect.md), [\<circle>](js-components-svg-circle.md), [\<ellipse>](../arkui-js/js-components-svg-ellipse.md), [\<path>](js-components-svg-path.md), [\<line](../arkui-js/js-components-svg-line.md), [\<polygon>](../arkui-js/js-components-svg-polygon.md), [\<polyline>](js-components-svg-polyline.md), [\<text>](js-components-svg-text.md), [\<animate>](js-components-svg-animate.md), and [\<animateTransform>](js-components-svg-animateTransform.md). The following are supported: [\<svg>](js-components-svg.md), [\<rect>](js-components-svg-rect.md), [\<circle>](js-components-svg-circle.md), [\<ellipse>](../arkui-js/js-components-svg-ellipse.md), [\<path>](js-components-svg-path.md), [\<line](../arkui-js/js-components-svg-line.md), [\<polygon>](../arkui-js/js-components-svg-polygon.md), [\<polyline>](js-components-svg-polyline.md), [\<text>](js-components-svg-text.md), [\<animate>](js-components-svg-animate.md), and [\<animateTransform>](js-components-svg-animatetransform.md).
## Attributes ## Attributes
The [universal attributes](../arkui-js/js-components-svg-common-attributes.md) and the attributes listed below are supported. The configured universal attributes are passed to the child components. The [universal attributes](../arkui-js/js-components-svg-common-attributes.md) and the attributes listed below are supported. The configured universal attributes are passed to the child components.
| Name| Type| Default Value| Mandatory| Description| | Name | Type | Default Value | Mandatory | Description |
| -------- | -------- | -------- | -------- | -------- | | ------- | ---------------------------------- | ------------- | --------- | ---------------------------------------- |
| id | string | - | No| Unique ID of the component.| | id | string | - | No | Unique ID of the component. |
| width | &lt;length&gt;\|&lt;percentage&gt; | - | No| Component width.| | width | &lt;length&gt;\|&lt;percentage&gt; | - | No | Component width. |
| height | &lt;length&gt;\|&lt;percentage&gt; | - | No| Component height.| | height | &lt;length&gt;\|&lt;percentage&gt; | - | No | Component height. |
| x | &lt;length&gt;\|&lt;percentage&gt; | - | No| X-coordinate of the current **\<svg>** component. The settings do not work for the root **\<svg>** node. | | x | &lt;length&gt;\|&lt;percentage&gt; | - | No | X-coordinate of the current **\<svg>** component. The settings do not work for the root **\<svg>** node. |
| y | &lt;length&gt;\|&lt;percentage&gt; | | No| Y-coordinate of the current **\<svg>** component. The settings do not work for the root **\<svg>** node. | | y | &lt;length&gt;\|&lt;percentage&gt; | | No | Y-coordinate of the current **\<svg>** component. The settings do not work for the root **\<svg>** node. |
| viewBox | string | - | No| View box of the current **\<svg>** component. The supported format is \<number number number number>. The four parameters indicate **min-x**, **min-y**, **width**, and **height**, respectively. The width and height of the view box are different from those of the **\<svg>** component. The view box is scaled in center-aligned mode. | | viewBox | string | - | No | View box of the current **\<svg>** component. The supported format is \<number number number number>. The four parameters indicate **min-x**, **min-y**, **width**, and **height**, respectively. The width and height of the view box are different from those of the **\<svg>** component. The view box is scaled in center-aligned mode. |
## Example ## Example
......
zh-cn/application-dev/application-models/Readme-CN.md
浏览文件 @ ba1a731a
...@@ -28,7 +28,7 @@ ...@@ -28,7 +28,7 @@
- [使用显式Want启动Ability](ability-startup-with-explicit-want.md) - [使用显式Want启动Ability](ability-startup-with-explicit-want.md)
- [使用隐式Want打开网址](ability-startup-with-implicit-want.md) - [使用隐式Want打开网址](ability-startup-with-implicit-want.md)
- [应用间使用Want分享数据](data-share-via-want.md) - [应用间使用Want分享数据](data-share-via-want.md)
- [组件启动规则](component-startup-rules.md) - [组件启动规则（Stage模型）](component-startup-rules.md)
- 应用组件跨设备交互（流转） - 应用组件跨设备交互（流转）
- [流转概述](inter-device-interaction-hop-overview.md) - [流转概述](inter-device-interaction-hop-overview.md)
- [跨端迁移（仅对系统应用开放）](hop-cross-device-migration.md) - [跨端迁移（仅对系统应用开放）](hop-cross-device-migration.md)
...@@ -84,6 +84,7 @@ ...@@ -84,6 +84,7 @@
- [服务卡片开发指导](widget-development-fa.md) - [服务卡片开发指导](widget-development-fa.md)
- [FA模型的Context](application-context-fa.md) - [FA模型的Context](application-context-fa.md)
- [信息传递载体Want](want-fa.md) - [信息传递载体Want](want-fa.md)
- [组件启动规则（FA模型）](component-startup-rules-fa.md)
- 进程间通信 - 进程间通信
- [进程模型](process-model-fa.md) - [进程模型](process-model-fa.md)
- [公共事件](common-event-fa.md) - [公共事件](common-event-fa.md)
......
zh-cn/application-dev/application-models/component-startup-rules-fa.md 0 → 100644
浏览文件 @ ba1a731a
# 组件启动规则（FA模型）
启动组件是指一切启动或连接应用组件的行为：
- 启动PageAbility、ServiceAbility，如使用startAbility()等相关接口。
- 连接ServiceAbility、DataAbility，如使用connectAbility()、acquireDataAbilityHelper()等相关接口。
在OpenHarmony中，为了保证用户具有更好的使用体验，对以下几种易影响用户体验与系统安全的行为做了限制：
- 后台应用任意弹框，如各种广告弹窗，影响用户使用。
- 后台应用相互唤醒，不合理的占用系统资源，导致系统功耗增加或系统卡顿。
- 前台应用任意跳转至其他应用，如随意跳转到其他应用的支付页面，存在安全风险。
鉴于此，OpenHarmony制订了一套组件启动规则，主要包括：
- **跨应用启动组件，需校验目标组件Visible**
- 只针对跨应用场景
- 若目标组件visible字段配置为false，则需校验`ohos.permission.START_INVISIBLE_ABILITY`权限
- [组件visible配置参考](../quick-start/module-configuration-file.md#abilities标签)
- **位于后台的应用，启动组件需校验BACKGROUND权限**
- 应用前后台判断标准：若应用进程获焦或所属的UIAbility位于前台则判定为前台应用，否则为后台应用
- 需校验`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限
- **跨应用启动FA模型的ServiceAbility组件或DataAbility组件，对端应用需配置关联启动**
- 只针对跨应用场景
- 只针对目标组件为ServiceAbility与DataAbility生效
- 目标应用的AssociateWakeUp为**ture**，其提供的ServiceAbility与DataAbility才允许被其他应用访问
- 只有系统预置应用才允许配置AssociateWakeUp字段，其余应用AssociateWakeUp默认为**false**
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 1. 组件启动管控自OpenHarmony v3.2 Release版本开始落地。
>
> 2. 与原本的启动规则不同，新的组件启动规则较为严格，开发者需熟知启动规则，避免业务功能异常。
启动组件的具体校验流程见下文。
## 同设备组件启动规则
设备内启动组件，不同场景下的规则不同，可分为如下两种场景：
- 启动PageAbility。
- 启动ServiceAbility或DataAbility。
![startup-rule](figures/component-startup-inner-fa.png)
## 分布式跨设备组件启动规则
跨设备启动组件，不同场景下的规则不同，可分为如下两种场景：
- 启动PageAbility。
- 启动ServiceAbility。
![component-startup-rules](figures/component-startup-inter-fa.png)
zh-cn/application-dev/application-models/component-startup-rules.md
浏览文件 @ ba1a731a
# 组件启动规则 # 组件启动规则（Stage模型）
启动组件是指一切启动或连接Ability的行为： 启动组件是指一切启动或连接应用组件的行为：
- 启动Ability，如使用startAbility()、startServiceExtensionAbility()、startAbilityByCall()等相关接口。 - 启动UIAbility、ServiceExtensionAbility、DataShareExtensionAbility，如使用startAbility()、startServiceExtensionAbility()、startAbilityByCall()等相关接口。
- 连接Ability，如使用connectAbility()、connectServiceExtensionAbility()、acquireDataAbilityHelper()、createDataShareHelper()等相关接口。 - 连接ServiceExtensionAbility、DataShareExtensionAbility，如使用connectServiceExtensionAbility()、createDataShareHelper()等相关接口。
在OpenHarmony中，为了保证用户具有更好的使用体验，对以下几种易影响用户体验与系统安全的行为做了限制： 在OpenHarmony中，为了保证用户具有更好的使用体验，对以下几种易影响用户体验与系统安全的行为做了限制：
...@@ -16,19 +16,22 @@ ...@@ -16,19 +16,22 @@
- 后台应用相互唤醒，不合理的占用系统资源，导致系统功耗增加或系统卡顿。 - 后台应用相互唤醒，不合理的占用系统资源，导致系统功耗增加或系统卡顿。
- 前台应用任意跳转至其他应用，如随意跳转到其他应用的支付Ability，存在安全风险。 - 前台应用任意跳转至其他应用，如随意跳转到其他应用的支付页面，存在安全风险。
鉴于此，OpenHarmony制订了一套组件启动规则，主要包括： 鉴于此，OpenHarmony制订了一套组件启动规则，主要包括：
- 应用位于后台时，启动组件需鉴权。 - **跨应用启动组件，需校验目标组件Visible**
- 若目标组件visible字段配置为false，则需校验`ohos.permission.START_INVISIBLE_ABILITY`权限
- [组件visible配置参考](../quick-start/module-configuration-file.md#abilities标签)
- 跨应用启动visible为false的组件，需鉴权。 - **位于后台的应用，启动组件需校验BACKGROUND权限**
- 应用前后台判断标准：若应用进程获焦或所属的UIAbility位于前台则判定为前台应用，否则为后台应用
- 需校验`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限
- 跨应用启动FA模型的ServiceAbility组件或DataAbility组件，对端应用需配置关联启动。 - **使用startAbilityByCall接口，需校验CALL权限**（使用方式参考：[Call调用开发指南（同设备）](uiability-intra-device-interaction.md#通过call调用实现uiability交互仅对系统应用开放)，[Call调用开发指南（跨设备）](hop-multi-device-collaboration.md#通过跨设备call调用实现多端协同)）
- 需校验`ohos.permission.ABILITY_BACKGROUND_COMMUNICATION`权限
- 使用startAbilityByCall接口，需鉴权（使用方式参考：[Call调用开发指南](hop-multi-device-collaboration.md#通过跨设备call调用实现多端协同)）
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
...@@ -36,87 +39,26 @@ ...@@ -36,87 +39,26 @@
> >
> 2. 与原本的启动规则不同，新的组件启动规则较为严格，开发者需熟知启动规则，避免业务功能异常。 > 2. 与原本的启动规则不同，新的组件启动规则较为严格，开发者需熟知启动规则，避免业务功能异常。
启动组件的具体校验流程见下文。
## 相关概念说明
为方便开发者理解管控规则，此处对所涉及的相关概念进行解释。
- **应用APL(Ability Privilege Level)**，表示应用的权限申请优先级的定义，不同APL等级的应用所能申请的权限不同，APL分为3个等级：
- 操作系统核心能力APL="system_core" (APL = 3)
- 系统基础服务APL="system_basic" (APL = 2)
- 三方应用程序APL="normal" (APL = 1)
- **注：三方应用默认都是APL="normal"**
- **BACKGROUND校验**
- 对发起端应用进程的状态进行判断，若应用进程获焦或所属的Ability位于前台则判定为前台应用，否则为后台应用
- 若发起端为后台应用，则需校验START_ABILITIES_FROM_BACKGROUND权限
- **VISIBLE校验**
- 只针对跨应用启动的场景
- 若目标组件visible配置为false，则需校验START_INVISIBLE_ABILITY权限
- **CALL校验**
- 只针对startAbilityByCall接口
- 需校验ABILITY_BACKGROUND_COMMUNICATION权限
- **关联启动(AssociateWakeUp)**
- 只有系统预置应用才允许配置AssociateWakeUp字段，其余应用AssociateWakeUp默认为**false**
- 只针对跨应用场景
- 只针对目标组件为**FA**模型的**ServiceAbility**与**DataAbility**生效
- 目标应用的AssociateWakeUp为**ture**，其提供的ServiceAbility与DataAbility才允许被其他应用访问
- **相关权限**
```json
{
"name": "ohos.permission.START_ABILITIES_FROM_BACKGROUND",
"grantMode": "system_grant",
"availableLevel": "system_basic", // APL等级至少为system_basic才可申请
"since": 9,
"deprecated": "",
"provisionEnable": true, // 支持ACL方式申请权限
"distributedSceneEnable": false
},
{
"name": "ohos.permission.START_INVISIBLE_ABILITY",
"grantMode": "system_grant",
"availableLevel": "system_core", // APL等级至少为system_core才可申请
"since": 9,
"deprecated": "",
"provisionEnable": true, // 支持ACL方式申请权限
"distributedSceneEnable": false
},
{
"name": "ohos.permission.ABILITY_BACKGROUND_COMMUNICATION",
"grantMode": "system_grant",
"availableLevel": "system_basic", // APL等级至少为system_basic才可申请
"since": 9,
"deprecated": "",
"provisionEnable": true, // 支持ACL方式申请权限
"distributedSceneEnable": false
}
```
## 同设备组件启动管控 ## 同设备组件启动规则
不同场景下的管控规则不同，可分为如下三种场景： 设备内启动组件，不同场景下的规则不同，可分为如下两种场景：
- 启动一般组件：（FA模型）PageAbility，（Stage模型）UIAbility、ServiceExtensionAbility、DataShareExtensionAbility。
- 启动FA模型的ServiceAbility或DataAbility。 - 启动或连接组件：UIAbility、ServiceExtensionAbility、DataShareExtensionAbility。
- 通过startAbilityByCall接口启动（Stage模型）UIAbility。 - 通过startAbilityByCall接口启动UIAbility。
![startup-rule](figures/startup-rule.png) ![startup-rule](figures/component-startup-inner-stage.png)
## 分布式跨设备组件启动管控 ## 分布式跨设备组件启动规则
不同场景下的管控规则不同，可分为如下三种场景： 跨设备启动组件，不同场景下的规则不同，可分为如下两种场景：
- 启动一般组件：（FA模型）PageAbility，（Stage模型）UIAbility、ServiceExtensionAbility。
- 启动FA模型的ServiceAbility。 - 启动或连接组件：UIAbility、ServiceExtensionAbility、DataShareExtensionAbility。
- 通过startAbilityByCall接口启动（Stage模型）UIAbility。 - 通过startAbilityByCall接口启动UIAbility。
![component-startup-rules](figures/component-startup-rules.jpg) ![component-startup-rules](figures/component-startup-inter-stage.png)
zh-cn/application-dev/application-models/module-switch.md
浏览文件 @ ba1a731a
...@@ -15,8 +15,8 @@ ...@@ -15,8 +15,8 @@
| distro对象中的moduleType | 标识当前HAP的类型，包括两种类型：entry和feature。另外，如果表示HAR包类型，请设置为har | type | 标签变更。 | | distro对象中的moduleType | 标识当前HAP的类型，包括两种类型：entry和feature。另外，如果表示HAR包类型，请设置为har | type | 标签变更。 |
| distro对象中的installationFree | 标识当前HAP是否支持免安装特性 | installationFree | 标签变更。 | | distro对象中的installationFree | 标识当前HAP是否支持免安装特性 | installationFree | 标签变更。 |
| distro对象中的deliveryWithInstall | 标识当前HAP是否支持随应用安装 | deliveryWithInstall | 标签变更。 | | distro对象中的deliveryWithInstall | 标识当前HAP是否支持随应用安装 | deliveryWithInstall | 标签变更。 |
| metaData | 标识HAP的元信息 | metadata | 具体差异如[表2](#表2 FA模型metaData和Stage中metadata对比)。 | | metaData | 标识HAP的元信息 | metadata | 具体差异如[表2](#表2-fa模型metadata和stage中metadata对比)。 |
| abilities | 标识当前模块内的所有Ability | abilities | 具体差异如[表5](#表5 FA模型和Stage中abilities差异对比)。 | | abilities | 标识当前模块内的所有Ability | abilities | 具体差异如[表5](#表5-fa模型和stage中abilities差异对比)。 |
| js | 标识基于ArkUI框架开发的JS模块集合，其中的每个元素代表一个JS模块的信息 | pages | Stage模型在module标签下保留该对象中的pages，window配置与pages的下一级。 | | js | 标识基于ArkUI框架开发的JS模块集合，其中的每个元素代表一个JS模块的信息 | pages | Stage模型在module标签下保留该对象中的pages，window配置与pages的下一级。 |
| shortcuts | 标识应用的快捷方式信息 | shortcut_config.json文件 | 在开发视图的resources/base/profile下面定义配置文件shortcut_config.json。 | | shortcuts | 标识应用的快捷方式信息 | shortcut_config.json文件 | 在开发视图的resources/base/profile下面定义配置文件shortcut_config.json。 |
| reqPermissions | 标识应用运行时向系统申请的权限 | requestPermissions | 标签名称变更。 | | reqPermissions | 标识应用运行时向系统申请的权限 | requestPermissions | 标签名称变更。 |
...@@ -33,7 +33,7 @@ ...@@ -33,7 +33,7 @@
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| parameters | 标识调用Ability时所有调用参数的元信息 | / | Stage模型不支持。 | | parameters | 标识调用Ability时所有调用参数的元信息 | / | Stage模型不支持。 |
| results | 标识Ability返回值的元信息 | / | Stage模型不支持。 | | results | 标识Ability返回值的元信息 | / | Stage模型不支持。 |
| customizeData | 该标签标识父级组件的自定义元信息，Parameters和results在application不可配 | metadata | 具体差异见[表3](#表3 FA模型metaData的customizeData和Stage中metadata对比)。 | | customizeData | 该标签标识父级组件的自定义元信息，Parameters和results在application不可配 | metadata | 具体差异见[表3](#表3-fa模型metadata的customizedata和stage中metadata对比)。 |
### 表3 FA模型metaData的customizeData和Stage中metadata对比 ### 表3 FA模型metaData的customizeData和Stage中metadata对比
...@@ -41,7 +41,7 @@ ...@@ -41,7 +41,7 @@
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| name | 标识数据项的键名称。字符串最大长度为255字节 | name | 无。 | | name | 标识数据项的键名称。字符串最大长度为255字节 | name | 无。 |
| value | 标识数据项的值。字符串最大长度为255字节。 | value | 无。 | | value | 标识数据项的值。字符串最大长度为255字节。 | value | 无。 |
| extra | 标识当前custom数据的格式，取值为表示extra的资源值。 | resource | 标签变更。具体实例见[表4](#表4 FA模型metaData和Stage中metadata示例)。 | | extra | 标识当前custom数据的格式，取值为表示extra的资源值。 | resource | 标签变更。具体实例见[表4](#表4-fa模型metadata和stage中metadata示例)。 |
### 表4 FA模型metaData和Stage中metadata示例 ### 表4 FA模型metaData和Stage中metadata示例
...@@ -58,7 +58,7 @@ ...@@ -58,7 +58,7 @@
| process | 运行应用程序或Ability的进程名称 | / | Stage模型不支持abilities中配置，在module标签下配置process | | process | 运行应用程序或Ability的进程名称 | / | Stage模型不支持abilities中配置，在module标签下配置process |
| uri | 标识Ability的统一资源标识符 | / | Stage模型不支持 | | uri | 标识Ability的统一资源标识符 | / | Stage模型不支持 |
| deviceCapability | 标识Ability运行时要求设备具有的能力，采用字符串数组的格式表示 | / | Stage模型不支持 | | deviceCapability | 标识Ability运行时要求设备具有的能力，采用字符串数组的格式表示 | / | Stage模型不支持 |
| metaData | 该标签标识ability的元信息。 | metadata | 具体差异如[表2](#表2 FA模型metaData和Stage中metadata对比) | | metaData | 该标签标识ability的元信息。 | metadata | 具体差异如[表2](#表2-fa模型metadata和stage中metadata对比) |
| type | 标识Ability的类型 | / | Stage模型不支持 | | type | 标识Ability的类型 | / | Stage模型不支持 |
| grantPermission | 指定是否可以向Ability内任何数据授予权限 | / | abilities内不支持； | | grantPermission | 指定是否可以向Ability内任何数据授予权限 | / | abilities内不支持； |
| readPermission | 标识读取Ability的数据所需的权限。该标签仅适用于data类型的Ability | / | abilities内不支持；在extensionAbilities标签中支持 | | readPermission | 标识读取Ability的数据所需的权限。该标签仅适用于data类型的Ability | / | abilities内不支持；在extensionAbilities标签中支持 |
......
zh-cn/application-dev/application-models/uiability-intra-device-interaction.md
浏览文件 @ ba1a731a
...@@ -367,7 +367,7 @@ export default class FuncAbility extends UIAbility { ...@@ -367,7 +367,7 @@ export default class FuncAbility extends UIAbility {
经常还会遇到一类场景，当应用A已经启动且处于主页面时，回到桌面，打开应用B，并从应用B再次启动应用A，且需要跳转到应用A的指定页面。例如联系人应用和短信应用配合使用的场景。打开短信应用主页，回到桌面，此时短信应用处于已打开状态且当前处于短信应用的主页。再打开联系人应用主页，进入联系人用户A查看详情，点击短信图标，准备给用户A发送短信，此时会再次拉起短信应用且当前处于短信应用的发送页面。 经常还会遇到一类场景，当应用A已经启动且处于主页面时，回到桌面，打开应用B，并从应用B再次启动应用A，且需要跳转到应用A的指定页面。例如联系人应用和短信应用配合使用的场景。打开短信应用主页，回到桌面，此时短信应用处于已打开状态且当前处于短信应用的主页。再打开联系人应用主页，进入联系人用户A查看详情，点击短信图标，准备给用户A发送短信，此时会再次拉起短信应用且当前处于短信应用的发送页面。
![uiability_not_first_started](figures/uiability_not_first_started.png) ![uiability_not_first_started](figures/uiability_not_first_started.png)
针对以上场景，即当应用A的UIAbility实例已创建，并且处于该UIAbility实例对应的主页面中，此时，从应用B中需要再次启动应用A的该UIAbility，并且需要跳转到不同的页面，这种情况下要如何实现呢？ 针对以上场景，即当应用A的UIAbility实例已创建，并且处于该UIAbility实例对应的主页面中，此时，从应用B中需要再次启动应用A的该UIAbility，并且需要跳转到不同的页面，这种情况下要如何实现呢？
...@@ -432,12 +432,12 @@ Call调用的使用场景主要包括： ...@@ -432,12 +432,12 @@ Call调用的使用场景主要包括：
**表1** Call调用相关名词解释 **表1** Call调用相关名词解释
| 名词 | 描述 | | 名词 | 描述 |
| -------- | -------- | | -------- | -------- |
| CallerAbility | 进行Call调用的UIAbility（调用方）。 | | CallerAbility | 进行Call调用的UIAbility（调用方）。 |
| CalleeAbility | 被Call调用的UIAbility（被调用方）。 | | CalleeAbility | 被Call调用的UIAbility（被调用方）。 |
| Caller | 实际对象，由startAbilityByCall接口返回，CallerAbility可使用Caller与CalleeAbility进行通信。 | | Caller | 实际对象，由startAbilityByCall接口返回，CallerAbility可使用Caller与CalleeAbility进行通信。 |
| Callee | 实际对象，被CalleeAbility持有，可与Caller进行通信。 | | Callee | 实际对象，被CalleeAbility持有，可与Caller进行通信。 |
Call调用示意图如下所示。 Call调用示意图如下所示。
...@@ -462,15 +462,15 @@ Call功能主要接口如下表所示。具体的API详见[接口文档](../refe ...@@ -462,15 +462,15 @@ Call功能主要接口如下表所示。具体的API详见[接口文档](../refe
**表2** Call功能主要接口 **表2** Call功能主要接口
| 接口名 | 描述 | | 接口名 | 描述 |
| -------- | -------- | | -------- | -------- |
| startAbilityByCall(want:&nbsp;Want):&nbsp;Promise&lt;Caller&gt; | 启动指定UIAbility并获取其Caller通信接口，默认为后台启动，通过配置want可实现前台启动，详见[接口文档](../reference/apis/js-apis-ability-context.md#abilitycontextstartabilitybycall)。AbilityContext与ServiceExtensionContext均支持该接口。 | | startAbilityByCall(want:&nbsp;Want):&nbsp;Promise&lt;Caller&gt; | 启动指定UIAbility并获取其Caller通信接口，默认为后台启动，通过配置want可实现前台启动，详见[接口文档](../reference/apis/js-apis-ability-context.md#abilitycontextstartabilitybycall)。AbilityContext与ServiceExtensionContext均支持该接口。 |
| on(method:&nbsp;string,&nbsp;callback:&nbsp;CalleeCallBack):&nbsp;void | 通用组件Callee注册method对应的callback方法。 | | on(method:&nbsp;string,&nbsp;callback:&nbsp;CalleeCallBack):&nbsp;void | 通用组件Callee注册method对应的callback方法。 |
| off(method:&nbsp;string):&nbsp;void | 通用组件Callee解注册method的callback方法。 | | off(method:&nbsp;string):&nbsp;void | 通用组件Callee解注册method的callback方法。 |
| call(method:&nbsp;string,&nbsp;data:&nbsp;rpc.Sequenceable):&nbsp;Promise&lt;void&gt; | 向通用组件Callee发送约定序列化数据。 | | call(method:&nbsp;string,&nbsp;data:&nbsp;rpc.Sequenceable):&nbsp;Promise&lt;void&gt; | 向通用组件Callee发送约定序列化数据。 |
| callWithResult(method:&nbsp;string,&nbsp;data:&nbsp;rpc.Sequenceable):&nbsp;Promise&lt;rpc.MessageParcel&gt; | 向通用组件Callee发送约定序列化数据,&nbsp;并将Callee返回的约定序列化数据带回。 | | callWithResult(method:&nbsp;string,&nbsp;data:&nbsp;rpc.Sequenceable):&nbsp;Promise&lt;rpc.MessageParcel&gt; | 向通用组件Callee发送约定序列化数据,&nbsp;并将Callee返回的约定序列化数据带回。 |
| release():&nbsp;void | 释放通用组件的Caller通信接口。 | | release():&nbsp;void | 释放通用组件的Caller通信接口。 |
| on(type:&nbsp;"release",&nbsp;callback:&nbsp;OnReleaseCallback):&nbsp;void | 注册通用组件通信断开监听通知。 | | on(type:&nbsp;"release",&nbsp;callback:&nbsp;OnReleaseCallback):&nbsp;void | 注册通用组件通信断开监听通知。 |
设备内通过Call调用实现UIAbility交互，涉及如下两部分开发： 设备内通过Call调用实现UIAbility交互，涉及如下两部分开发：
...@@ -486,9 +486,9 @@ Call功能主要接口如下表所示。具体的API详见[接口文档](../refe ...@@ -486,9 +486,9 @@ Call功能主要接口如下表所示。具体的API详见[接口文档](../refe
1. 配置Ability的启动模式。 1. 配置Ability的启动模式。
配置module.json5，将CalleeAbility配置为单实例"singleton"。 配置module.json5，将CalleeAbility配置为单实例"singleton"。
| Json字段 | 字段说明 | | Json字段 | 字段说明 |
| -------- | -------- | | -------- | -------- |
| "launchType" | Ability的启动模式，设置为"singleton"类型。 | | "launchType" | Ability的启动模式，设置为"singleton"类型。 |
Ability配置标签示例如下： Ability配置标签示例如下：
......
zh-cn/application-dev/faqs/faqs-ability.md
浏览文件 @ ba1a731a
...@@ -60,7 +60,7 @@ build() { ...@@ -60,7 +60,7 @@ build() {
Ability配置中缺少startWindowIcon属性配置，需要在module.json5中abilities中配置startWindowIcon。 Ability配置中缺少startWindowIcon属性配置，需要在module.json5中abilities中配置startWindowIcon。
参考文档：[Stage模型应用程序包结构](../quick-start/application-package-structure-stage.md) 参考文档：[Stage模型应用程序包结构](../quick-start/module-configuration-file.md)
示例： 示例：
...@@ -95,7 +95,7 @@ Ability配置中缺少startWindowIcon属性配置，需要在module.json5中abil ...@@ -95,7 +95,7 @@ Ability配置中缺少startWindowIcon属性配置，需要在module.json5中abil
## 如何在应用A中去获取应用B的Hap包的安装路径 ## 如何在应用A中去获取应用B的Hap包的安装路径
适用于：OpenHarmony SDK 3..0以上版本， API9 Stage模型 适用于：OpenHarmony SDK 3.0以上版本， API9 Stage模型
首先需要申请系统权限，具体参看文档：[自动化签名](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-auto-configuring-signature-information-0000001271659465)。导入bundle模块，通过调用bundle.getApplicationInfo()接口，通过包名获取应用信息。然后通过application.moduleSourceDirs获取应用存储路径。 首先需要申请系统权限，具体参看文档：[自动化签名](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-auto-configuring-signature-information-0000001271659465)。导入bundle模块，通过调用bundle.getApplicationInfo()接口，通过包名获取应用信息。然后通过application.moduleSourceDirs获取应用存储路径。
......
zh-cn/application-dev/faqs/faqs-media.md
浏览文件 @ ba1a731a
...@@ -34,7 +34,7 @@ for(let cameraIndex = 0; cameraIndex < this.cameraArray.length; cameraIndex++) { ...@@ -34,7 +34,7 @@ for(let cameraIndex = 0; cameraIndex < this.cameraArray.length; cameraIndex++) {
break break
} }
} }
cameraInput = await this.cameraManager.createCameraInput(cameraId)熊文帅 cameraInput = await this.cameraManager.createCameraInput(cameraId)
``` ```
## 如何进行图片剪切 ## 如何进行图片剪切
......
zh-cn/application-dev/quick-start/application-package-structure-fa.md
浏览文件 @ ba1a731a
# FA模型应用程序包结构 # FA模型应用程序包结构
基于[FA模型](application-configuration-file-overview-fa.md)开发的应用，其应用程序包结构如图[应用程序包结构（FA模型）](figures/FA_3.png)所示。开发者需要熟悉应用程序包结构相关的基本概念。 基于[FA模型](application-configuration-file-overview-fa.md)开发的应用，其应用程序包结构如下图**应用程序包结构（FA模型）**所示。开发者需要熟悉应用程序包结构相关的基本概念。
FA模型与Stage模型不同之处在于HAP内部文件存放位置不同，FA模型将所有的资源文件、库文件和代码文件都放在assets文件夹中，在文件夹内部进一步区分。 FA模型与Stage模型不同之处在于HAP内部文件存放位置不同，FA模型将所有的资源文件、库文件和代码文件都放在assets文件夹中，在文件夹内部进一步区分。
...@@ -11,7 +11,7 @@ FA模型与Stage模型不同之处在于HAP内部文件存放位置不同，FA ...@@ -11,7 +11,7 @@ FA模型与Stage模型不同之处在于HAP内部文件存放位置不同，FA
- assets是HAP所有的资源文件、库文件和代码文件的集合，内部可以分为entry和js文件夹。entry文件夹中存放的是resources目录和resources.index文件。 - assets是HAP所有的资源文件、库文件和代码文件的集合，内部可以分为entry和js文件夹。entry文件夹中存放的是resources目录和resources.index文件。
- resources目录用于存放应用的资源文件（字符串、图片等），便于开发者使用和维护，详见[资源文件的使用](../key-features/multi-device-app-dev/resource-usage.md/)。 - resources目录用于存放应用的资源文件（字符串、图片等），便于开发者使用和维护，详见[资源文件的使用](../key-features/multi-device-app-dev/resource-usage.md)。
- resources.index是资源索引表，由IDE调用SDK工具生成。 - resources.index是资源索引表，由IDE调用SDK工具生成。
...@@ -19,6 +19,5 @@ FA模型与Stage模型不同之处在于HAP内部文件存放位置不同，FA ...@@ -19,6 +19,5 @@ FA模型与Stage模型不同之处在于HAP内部文件存放位置不同，FA
- pack.info是Bundle中用于描述每个HAP属性的文件，例如app中的bundleName和versionCode信息、module中的name、type和abilities等信息，由IDE工具生成Bundle包时自动生成。 - pack.info是Bundle中用于描述每个HAP属性的文件，例如app中的bundleName和versionCode信息、module中的name、type和abilities等信息，由IDE工具生成Bundle包时自动生成。
**图1** 应用程序包结构（FA模型）
**图1** 应用程序包结构（FA模型）   ![app-pack-fa](figures/app-pack-fa.png)
![FA_3](figures/FA_3.png) \ No newline at end of file
zh-cn/application-dev/quick-start/application-package-structure-stage.md
浏览文件 @ ba1a731a
# Stage模型应用程序包结构 # Stage模型应用程序包结构
基于[Stage模型](application-configuration-file-overview-stage.md)开发的应用，经编译打包后，其应用程序包结构如图[应用程序包结构（Stage模型）](figures/Stage-.png)所示。开发者需要熟悉应用程序包结构相关的基本概念。 基于[Stage模型](application-configuration-file-overview-stage.md)开发的应用，经编译打包后，其应用程序包结构如下图**应用程序包结构（Stage模型）**所示。开发者需要熟悉应用程序包结构相关的基本概念。
- 在开发态，一个应用包含一个或者多个Module，可以在[DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio/)工程中[创建一个或者多个Module](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ohos-adding-deleting-module-0000001218760594-V3)。Module是OpenHarmony应用/服务的基本功能单元，包含了源代码、资源文件、第三方库及应用/服务配置文件，每一个Module都可以独立进行编译和运行。Module分为“Ability”和“Library”两种类型，“Ability”类型的Module对应于编译后的HAP（Harmony Ability Package）；“Library”类型的Module对应于[HAR](har-structure.md)（Harmony Ability Resources）包，即编译后的.tgz文件。 - 在开发态，一个应用包含一个或者多个Module，可以在[DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio/)工程中[创建一个或者多个Module](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ohos-adding-deleting-module-0000001218760594-V3)。Module是OpenHarmony应用/服务的基本功能单元，包含了源代码、资源文件、第三方库及应用/服务配置文件，每一个Module都可以独立进行编译和运行。Module分为“Ability”和“Library”两种类型，“Ability”类型的Module对应于编译后的HAP（Harmony Ability Package）；“Library”类型的Module对应于[HAR](har-structure.md)（Harmony Ability Resources）包，即编译后的.tgz文件。
一个Module可以包含一个或多个[UIAbility](../application-models/uiability-overview.md)组件，如[Module与UIAbility组件关系示意图](figures/ability-and-module.png)所示。 一个Module可以包含一个或多个[UIAbility](../application-models/uiability-overview.md)组件，如[Module与UIAbility组件关系示意图](figures/ability-and-module.png)所示。
**图1** Module与UIAbility组件关系示意图   **图1** Module与UIAbility组件关系示意图
![ability-and-module](figures/ability-and-module.png) ![ability-and-module](figures/ability-and-module.png)
全文中介绍到的Module默认指的是“Ability”类型的Module。 全文中介绍到的Module默认指的是“Ability”类型的Module。
...@@ -21,10 +21,10 @@ ...@@ -21,10 +21,10 @@
- 打包后的HAP包结构包括ets、libs、resources等文件夹和resources.index、module.json、pack.info等文件。 - 打包后的HAP包结构包括ets、libs、resources等文件夹和resources.index、module.json、pack.info等文件。
- ets目录用于存放应用代码编译后的字节码文件。 - ets目录用于存放应用代码编译后的字节码文件。
- libs目录用于存放库文件。库文件是OpenHarmony应用依赖的第三方代码（例如.so、.jar、.bin、.har等二进制文件）。 - libs目录用于存放库文件。库文件是OpenHarmony应用依赖的第三方代码（例如.so、.jar、.bin、.har等二进制文件）。
- resources目录用于存放应用的资源文件（字符串、图片等），便于开发者使用和维护，详见[资源文件的使用](../key-features/multi-device-app-dev/resource-usage.md/)。 - resources目录用于存放应用的资源文件（字符串、图片等），便于开发者使用和维护，详见[资源文件的使用](../key-features/multi-device-app-dev/resource-usage.md)。
- resources.index是资源索引表，由IDE编译工程时生成。 - resources.index是资源索引表，由IDE编译工程时生成。
- module.json是HAP的配置文件，内容由工程配置中的module.json5和app.json5组成，该文件是HAP中必不可少的文件。IDE会自动生成一部分默认配置，开发者按需修改其中的配置。详细字段请参见[应用配置文件](application-configuration-file-overview-stage.md)。 - module.json是HAP的配置文件，内容由工程配置中的module.json5和app.json5组成，该文件是HAP中必不可少的文件。IDE会自动生成一部分默认配置，开发者按需修改其中的配置。详细字段请参见[应用配置文件](application-configuration-file-overview-stage.md)。
- pack.info是Bundle中用于描述每个HAP属性的文件，例如app中的bundleName和versionCode信息、module中的name、type和abilities等信息，由IDE工具生成Bundle包时自动生成。 - pack.info是Bundle中用于描述每个HAP属性的文件，例如app中的bundleName和versionCode信息、module中的name、type和abilities等信息，由IDE工具生成Bundle包时自动生成。
**图2** 应用程序包结构（Stage模型）   **图2** 应用程序包结构（Stage模型）
![Stage-](figures/Stage-.png) ![app-pack-stage](figures/app-pack-stage.png)
zh-cn/application-dev/quick-start/start-with-ets-fa.md
浏览文件 @ ba1a731a
...@@ -40,7 +40,7 @@ ...@@ -40,7 +40,7 @@
- **src &gt; main &gt; ets &gt; MainAbility &gt; pages &gt; index.ets**：pages列表中的第一个页面，即应用的首页入口。 - **src &gt; main &gt; ets &gt; MainAbility &gt; pages &gt; index.ets**：pages列表中的第一个页面，即应用的首页入口。
- **src &gt; main &gt; ets &gt; MainAbility &gt; app.ets**：承载Ability生命周期。 - **src &gt; main &gt; ets &gt; MainAbility &gt; app.ets**：承载Ability生命周期。
- **src &gt; main &gt; resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源文件的分类](resource-categories-and-access.md#资源分类)。 - **src &gt; main &gt; resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源文件的分类](resource-categories-and-access.md#资源分类)。
- **src &gt; main &gt; config.json**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[FA模型应用程序包结构](application-package-structure-fa.md)。 - **src &gt; main &gt; config.json**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[应用配置文件（FA模型）](application-configuration-file-overview-fa.md)。
- **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。 - **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。
- **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。 - **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。
......
zh-cn/application-dev/quick-start/start-with-ets-stage.md
浏览文件 @ ba1a731a
...@@ -38,7 +38,7 @@ ...@@ -38,7 +38,7 @@
- **src &gt; main &gt; ets &gt; entryability**：应用/服务的入口。 - **src &gt; main &gt; ets &gt; entryability**：应用/服务的入口。
- **src &gt; main &gt; ets &gt; pages**：应用/服务包含的页面。 - **src &gt; main &gt; ets &gt; pages**：应用/服务包含的页面。
- **src &gt; main &gt; resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源文件的分类](resource-categories-and-access.md#资源分类)。 - **src &gt; main &gt; resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源文件的分类](resource-categories-and-access.md#资源分类)。
- **src &gt; main &gt; module.json5**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[Stage模型应用程序包结构](application-package-structure-stage.md)。 - **src &gt; main &gt; module.json5**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[module.json5配置文件](module-configuration-file.md)。
- **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。 - **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。
- **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。 - **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。
......
zh-cn/application-dev/quick-start/start-with-js-fa.md
浏览文件 @ ba1a731a
...@@ -39,7 +39,7 @@ ...@@ -39,7 +39,7 @@
- **src &gt; main &gt; js &gt; MainAbility &gt; app.js**：承载Ability生命周期。 - **src &gt; main &gt; js &gt; MainAbility &gt; app.js**：承载Ability生命周期。
- **src &gt; main &gt; resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源限定与访问](../ui/js-framework-resource-restriction.md)。 - **src &gt; main &gt; resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源限定与访问](../ui/js-framework-resource-restriction.md)。
- **src &gt; main &gt; config.json**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[FA模型应用程序包结构](application-package-structure-fa.md)。 - **src &gt; main &gt; config.json**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[应用配置文件（FA模型）](application-configuration-file-overview-fa.md)。
- **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。 - **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。
- **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。 - **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。
......
zh-cn/application-dev/reference/apis/js-apis-ability-Want.md 已删除 100644 → 0
浏览文件 @ 7f821a59
# Want
Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
> **说明：**
>
> 本模块首批接口从API version 6开始支持，从API version 9废弃，替换模块为[Want (Want)](js-apis-app-ability-Want.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块
```ts
import Want from '@ohos.application.Want'
```
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ |
| deviceId | 是 | 否 | string | 否 | 表示运行指定Ability的设备ID。 |
| bundleName | 是 | 否 | string | 否 | 表示包名。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 |
| abilityName | 是 | 否 | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
| uri | 是 | 否 | string | 否 | 表示Uri。如果在Want中指定了Uri，则Want将匹配指定的Uri信息，包括scheme, schemeSpecificPart, authority和path信息。 |
| type | 是 | 否 | string | 否 | 表示MIME type类型，打开文件的类型，主要用于文管打开文件。比如："text/xml" 、 "image/*"等，MIME定义参考：https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 |
| flags | 是 | 否 | number | 否 | 表示处理Want的方式。默认传数字，具体参考：[flags说明](js-apis-featureAbility.md#flags说明)。 |
| action | 是 | 否 | string | 否 | 表示要执行的通用操作（如：查看、分享、应用详情）。在隐式Want中，您可以定义该字段，配合uri或parameters来表示对数据要执行的操作。 |
| parameters | 是 | 否 | {[key: string]: any} | 否 | 表示WantParams，由开发者自行决定传入的键值对。默认会携带以下key值：<br>ohos.aafwk.callerPid 表示拉起方的pid。<br>ohos.aafwk.param.callerToken 表示拉起方的token。<br>ohos.aafwk.param.callerUid 表示[bundleInfo](js-apis-bundle-BundleInfo.md#bundleinfo-1)中的uid，应用包里应用程序的uid。 |
| entities | 是 | 否 | Array\<string> | 否 | 表示目标Ability额外的类别信息（如：浏览器、视频播放器），在隐式Want中是对action字段的补充。在隐式Want中，您可以定义该字段，来过滤匹配Ability类型。 |
| moduleName<sup>9+</sup> | 是 | 否 | string | 否 | 表示待启动的Ability所属的模块（module）。 |
具体字段描述参考ability/want.d.ts文件
**示例：**
- 基础用法
``` ts
var want = {
"deviceId": "", // deviceId为空表示本设备
"bundleName": "com.extreme.test",
"abilityName": "MainAbility",
"moduleName": "entry" // moduleName非必选
};
this.context.startAbility(want, (error) => {
// 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.log("error.code = " + error.code)
})
```
- 传递FD数据，FD表示文件描述符(FileDescriptor)
``` ts
import fileio from '@ohos.fileio';
var fd;
try {
fd = fileio.openSync("/data/storage/el2/base/haps/pic.png");
} catch(e) {
console.log("openSync fail:" + JSON.stringify(e));
}
var want = {
"deviceId": "", // deviceId为空表示本设备
"bundleName": "com.extreme.test",
"abilityName": "MainAbility",
"moduleName": "entry", // moduleName非必选
"parameters": {
"keyFd":{"type":"FD", "value":fd}
}
};
this.context.startAbility(want, (error) => {
// 显式拉起Ability，通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.log("error.code = " + error.code)
})
```
<!--no_check-->
zh-cn/application-dev/reference/apis/js-apis-ability-ability.md
浏览文件 @ ba1a731a
...@@ -15,24 +15,25 @@ import ability from '@ohos.ability.ability' ...@@ -15,24 +15,25 @@ import ability from '@ohos.ability.ability'
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 描述 |
| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ | | ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| DataAbilityHelper | 是 | 否 | number | 否 | DataAbilityHelper二级模块。 | | DataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 否 | DataAbilityHelper二级模块。 |
| PacMap | 是 | 否 | Want | 否 | PacMap二级模块。 | | PacMap | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#PacMap) | 否 | PacMap二级模块。 |
| DataAbilityOperation | 是 | 否 | Want | 否 | DataAbilityOperation二级模块。 | | DataAbilityOperation | [DataAbilityOperation](js-apis-inner-ability-dataAbilityOperation.md) | 否 | DataAbilityOperation二级模块。 |
| DataAbilityResult | 是 | 否 | Want | 否 | DataAbilityResult二级模块。 | | DataAbilityResult | [DataAbilityResult](js-apis-inner-ability-dataAbilityResult.md) | 否 | DataAbilityResult二级模块。 |
| AbilityResult | 是 | 否 | Want | 否 | AbilityResult二级模块。 | | AbilityResult | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 否 | AbilityResult二级模块。 |
| ConnectOptions | 是 | 否 | Want | 否 | ConnectOptions二级模块。 | | ConnectOptions | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 否 | ConnectOptions二级模块。 |
| StartAbilityParameter | 是 | 否 | Want | 否 | StartAbilityParameter二级模块。 | | StartAbilityParameter | [StartAbilityParameter](js-apis-inner-ability-startAbilityParameter.md) | 否 | StartAbilityParameter二级模块。 |
**示例：** **示例：**
```ts
```ts import ability from '@ohos.ability.ability';
let dataAbilityHelper: ability.DataAbilityHelper;
let pacMap: ability.PacMap; let dataAbilityHelper: ability.DataAbilityHelper;
let dataAbilityOperation: ability.DataAbilityOperation; let pacMap: ability.PacMap;
let dataAbilityResult: ability.DataAbilityResult; let dataAbilityOperation: ability.DataAbilityOperation;
let abilityResult: ability.AbilityResult; let dataAbilityResult: ability.DataAbilityResult;
let connectOptions: ability.ConnectOptions; let abilityResult: ability.AbilityResult;
let startAbilityParameter: ability.StartAbilityParameter; let connectOptions: ability.ConnectOptions;
``` let startAbilityParameter: ability.StartAbilityParameter;
\ No newline at end of file ```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-DataUriUtils.md → zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
浏览文件 @ ba1a731a
...@@ -8,7 +8,7 @@ DataUriUtils模块提供用于处理使用DataAbilityHelper方案的对象的实 ...@@ -8,7 +8,7 @@ DataUriUtils模块提供用于处理使用DataAbilityHelper方案的对象的实
## 导入模块 ## 导入模块
```js ```ts
import dataUriUtils from '@ohos.ability.dataUriUtils'; import dataUriUtils from '@ohos.ability.dataUriUtils';
``` ```
...@@ -34,7 +34,7 @@ getId(uri: string): number ...@@ -34,7 +34,7 @@ getId(uri: string): number
**示例：** **示例：**
```js ```ts
dataUriUtils.getId("com.example.dataUriUtils/1221") dataUriUtils.getId("com.example.dataUriUtils/1221")
``` ```
...@@ -63,7 +63,7 @@ attachId(uri: string, id: number): string ...@@ -63,7 +63,7 @@ attachId(uri: string, id: number): string
**示例：** **示例：**
```js ```ts
var idint = 1122; var idint = 1122;
dataUriUtils.attachId( dataUriUtils.attachId(
"com.example.dataUriUtils", "com.example.dataUriUtils",
...@@ -95,7 +95,7 @@ deleteId(uri: string): string ...@@ -95,7 +95,7 @@ deleteId(uri: string): string
**示例：** **示例：**
```js ```ts
dataUriUtils.deleteId("com.example.dataUriUtils/1221") dataUriUtils.deleteId("com.example.dataUriUtils/1221")
``` ```
...@@ -124,7 +124,7 @@ updateId(uri: string, id: number): string ...@@ -124,7 +124,7 @@ updateId(uri: string, id: number): string
**示例：** **示例：**
```js ```ts
var idint = 1122; var idint = 1122;
dataUriUtils.updateId( dataUriUtils.updateId(
"com.example.dataUriUtils", "com.example.dataUriUtils",
......
zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
浏览文件 @ ba1a731a
...@@ -10,7 +10,7 @@ ErrorCode是定义启动功能时使用的错误代码。 ...@@ -10,7 +10,7 @@ ErrorCode是定义启动功能时使用的错误代码。
## 导入模块 ## 导入模块
``` ```ts
import errorCode from '@ohos.ability.errorCode' import errorCode from '@ohos.ability.errorCode'
``` ```
...@@ -24,5 +24,5 @@ import errorCode from '@ohos.ability.errorCode' ...@@ -24,5 +24,5 @@ import errorCode from '@ohos.ability.errorCode'
| ------------------------------ | ---- | ---------------------------------------- | | ------------------------------ | ---- | ---------------------------------------- |
| NO_ERROR | 0 | 没有错误。 | | NO_ERROR | 0 | 没有错误。 |
| INVALID_PARAMETER | -1 | 无效的参数。 | | INVALID_PARAMETER | -1 | 无效的参数。 |
| ABILITY_NOT_FOUND | -2 | 找不到能力。 | | ABILITY_NOT_FOUND | -2 | 找不到ABILITY。 |
| PERMISSION_DENY | -3 | 拒绝许可。 | | PERMISSION_DENY | -3 | 拒绝许可。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
浏览文件 @ ba1a731a
...@@ -8,7 +8,7 @@ wantConstant模块提供want中操作want常数和解释Flags说明的能力。 ...@@ -8,7 +8,7 @@ wantConstant模块提供want中操作want常数和解释Flags说明的能力。
## 导入模块 ## 导入模块
```js ```ts
import wantConstant from '@ohos.ability.wantConstant'; import wantConstant from '@ohos.ability.wantConstant';
``` ```
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-ability.md 0 → 100644
浏览文件 @ ba1a731a
# Ability
Ability模块提供对Ability生命周期、上下文环境等调用管理的能力，包括Ability创建、销毁、转储客户端信息等。
> **说明：**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
## 导入模块
```ts
import Ability from '@ohos.app.ability.Ability';
```
## Ability.onConfigurationUpdate
onConfigurationUpdate(config: Configuration): void;
当系统配置更新时调用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 表示需要更新的配置信息。 |
**示例：**
```ts
class myAbility extends Ability {
onConfigurationUpdate(config) {
console.log('onConfigurationUpdate, config:' + JSON.stringify(config));
}
}
```
## Ability.onMemoryLevel
onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| level | [AbilityConstant.MemoryLevel](js-apis-app-ability-abilityConstant.md#abilityconstantmemorylevel) | 是 | 回调返回内存微调级别，显示当前内存使用状态。|
**示例：**
```ts
class myAbility extends Ability {
onMemoryLevel(level) {
console.log('onMemoryLevel, level:' + JSON.stringify(level));
}
}
```
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @ ba1a731a
...@@ -11,7 +11,7 @@ AbilityConstant提供启动参数的接口的能力，包括设置初次开始 ...@@ -11,7 +11,7 @@ AbilityConstant提供启动参数的接口的能力，包括设置初次开始
## 导入模块 ## 导入模块
```js ```ts
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
``` ```
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md 0 → 100644
浏览文件 @ ba1a731a
# AbilityDelegatorRegistry
AbilityDelegatorRegistry模块提供用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力，包括获取应用程序的AbilityDelegator对象、获取单元测试参数AbilityDelegatorArgs对象。
> **说明：**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块
```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'
```
## AbilityLifecycleState
Ability生命周期状态。
**系统能力** ：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 |
| ------------- | ---- | --------------------------- |
| UNINITIALIZED | 0 | 表示无效状态。 |
| CREATE | 1 | 表示Ability处于已创建状态。 |
| FOREGROUND | 2 | 表示Ability处于前台状态。 |
| BACKGROUND | 3 | 表示Ability处于后台状态。 |
| DESTROY | 4 | 表示Ability处于已销毁状态。 |
## AbilityDelegatorRegistry.getAbilityDelegator
getAbilityDelegator(): AbilityDelegator
获取应用程序的AbilityDelegator对象
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**返回值：**
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| [AbilityDelegator](js-apis-inner-application-abilityDelegator.md#AbilityDelegator) | [AbilityDelegator](js-apis-inner-application-abilityDelegator.md#AbilityDelegator)对象。可以用来调度测试框架相关功能。 |
**示例：**
```ts
var abilityDelegator;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
```
## AbilityDelegatorRegistry.getArguments
getArguments(): AbilityDelegatorArgs
获取单元测试参数AbilityDelegatorArgs对象
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core
**返回值：**
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md) | [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs.md)对象。可以用来获取测试参数。 |
**示例：**
```ts
var args = AbilityDelegatorRegistry.getArguments();
console.info("getArguments bundleName:" + args.bundleName);
console.info("getArguments testCaseNames:" + args.testCaseNames);
console.info("getArguments testRunnerClassName:" + args.testRunnerClassName);
```
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
浏览文件 @ ba1a731a
...@@ -10,7 +10,7 @@ AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命 ...@@ -10,7 +10,7 @@ AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命
## 导入模块 ## 导入模块
```js ```ts
import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback"; import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback";
``` ```
...@@ -156,7 +156,7 @@ onAbilityContinue(ability: UIAbility): void; ...@@ -156,7 +156,7 @@ onAbilityContinue(ability: UIAbility): void;
**示例：** **示例：**
```js ```ts
import UIAbility from "@ohos.app.ability.UIAbility"; import UIAbility from "@ohos.app.ability.UIAbility";
export default class MyAbility extends UIAbility { export default class MyAbility extends UIAbility {
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
浏览文件 @ ba1a731a
...@@ -9,7 +9,7 @@ AbilityManager模块提供对Ability相关信息和状态信息进行获取、 ...@@ -9,7 +9,7 @@ AbilityManager模块提供对Ability相关信息和状态信息进行获取、
## 导入模块 ## 导入模块
```js ```ts
import AbilityManager from '@ohos.app.ability.abilityManager' import AbilityManager from '@ohos.app.ability.abilityManager'
``` ```
...@@ -48,7 +48,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -48,7 +48,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
**示例**： **示例**：
```js ```ts
import abilitymanager from '@ohos.app.ability.abilityManager'; import abilitymanager from '@ohos.app.ability.abilityManager';
var config = { var config = {
...@@ -89,7 +89,7 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -89,7 +89,7 @@ updateConfiguration(config: Configuration): Promise\<void>
**示例**： **示例**：
```js ```ts
import abilitymanager from '@ohos.app.ability.abilityManager'; import abilitymanager from '@ohos.app.ability.abilityManager';
var config = { var config = {
...@@ -126,7 +126,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo ...@@ -126,7 +126,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
**示例**： **示例**：
```js ```ts
import abilitymanager from '@ohos.app.ability.abilityManager'; import abilitymanager from '@ohos.app.ability.abilityManager';
try { try {
...@@ -157,7 +157,7 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> ...@@ -157,7 +157,7 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
**示例**： **示例**：
```js ```ts
import abilitymanager from '@ohos.app.ability.abilityManager'; import abilitymanager from '@ohos.app.ability.abilityManager';
try { try {
...@@ -191,7 +191,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext ...@@ -191,7 +191,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
**示例**： **示例**：
```js ```ts
import abilitymanager from '@ohos.app.ability.abilityManager'; import abilitymanager from '@ohos.app.ability.abilityManager';
var upperLimit = 0; var upperLimit = 0;
...@@ -230,7 +230,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn ...@@ -230,7 +230,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
**示例**： **示例**：
```js ```ts
import abilitymanager from '@ohos.app.ability.abilityManager'; import abilitymanager from '@ohos.app.ability.abilityManager';
var upperLimit = 0; var upperLimit = 0;
...@@ -263,7 +263,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void; ...@@ -263,7 +263,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
**示例**： **示例**：
```js ```ts
import abilitymanager from '@ohos.app.ability.abilityManager'; import abilitymanager from '@ohos.app.ability.abilityManager';
try { try {
...@@ -292,7 +292,7 @@ getTopAbility(): Promise\<ElementName>; ...@@ -292,7 +292,7 @@ getTopAbility(): Promise\<ElementName>;
**示例**： **示例**：
```js ```ts
import abilitymanager from '@ohos.app.ability.abilityManager'; import abilitymanager from '@ohos.app.ability.abilityManager';
try { try {
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md
浏览文件 @ ba1a731a
...@@ -17,7 +17,7 @@ import Configuration from '@ohos.app.ability.Configuration' ...@@ -17,7 +17,7 @@ import Configuration from '@ohos.app.ability.Configuration'
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| language | string | 是 | 是 | 表示应用程序的当前语言。 | | language | string | 是 | 是 | 表示应用程序的当前语言。 |
| colorMode | [ColorMode](js-apis-app-ability-configurationconstant.md#configurationconstantcolormode) | 是 | 是 | 表示深浅色模式，取值范围：浅色模式（COLOR_MODE_LIGHT），深色模式（COLOR_MODE_DARK）。默认为浅色。 | | colorMode | [ColorMode](js-apis-app-ability-configurationConstant.md#configurationconstantcolormode) | 是 | 是 | 表示深浅色模式，取值范围：浅色模式（COLOR_MODE_LIGHT），深色模式（COLOR_MODE_DARK）。默认为浅色。 |
| direction | Direction | 是 | 否 | 表示屏幕方向，取值范围：水平方向（DIRECTION_HORIZONTAL），垂直方向（DIRECTION_VERTICAL）。 | | direction | Direction | 是 | 否 | 表示屏幕方向，取值范围：水平方向（DIRECTION_HORIZONTAL），垂直方向（DIRECTION_VERTICAL）。 |
| screenDensity | ScreenDensity | 是 | 否 | 表示屏幕分辨率，取值范围：SCREEN_DENSITY_SDPI（120）、SCREEN_DENSITY_MDPI（160）、SCREEN_DENSITY_LDPI（240）、SCREEN_DENSITY_XLDPI（320）、SCREEN_DENSITY_XXLDPI（480）、SCREEN_DENSITY_XXXLDPI（640）。 | | screenDensity | ScreenDensity | 是 | 否 | 表示屏幕分辨率，取值范围：SCREEN_DENSITY_SDPI（120）、SCREEN_DENSITY_MDPI（160）、SCREEN_DENSITY_LDPI（240）、SCREEN_DENSITY_XLDPI（320）、SCREEN_DENSITY_XXLDPI（480）、SCREEN_DENSITY_XXXLDPI（640）。 |
| displayId | number | 是 | 否 | 表示应用所在的物理屏幕Id。 | | displayId | number | 是 | 否 | 表示应用所在的物理屏幕Id。 |
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-StartOptions.md → zh-cn/application-dev/reference/apis/js-apis-app-ability-startOptions.md
浏览文件 @ ba1a731a
...@@ -9,15 +9,16 @@ StartOptions模块对系统的基本通信组件进行查询和设置的能力 ...@@ -9,15 +9,16 @@ StartOptions模块对系统的基本通信组件进行查询和设置的能力
## 导入模块 ## 导入模块
``` ```ts
import StartOptions from '@ohos.app.ability.StartOptions'; import StartOptions from '@ohos.app.ability.StartOptions';
``` ```
## 属性 ## 属性
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| [windowMode](js-apis-window.md#windowmodesup7sup) | number | 否 | 窗口模式。 | | [windowMode](js-apis-application-abilityConstant.md#abilityconstantwindowmode) | number | 否 | 窗口模式。 |
| displayId | number | 否 | 显示ID。 | | displayId | number | 否 | 显示ID。 |
zh-cn/release-notes/OpenHarmony-v3.0.7-LTS.md 0 → 100644
浏览文件 @ ba1a731a
此差异已折叠。
zh-cn/release-notes/Readme.md
浏览文件 @ ba1a731a
此差异已折叠。
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或