diff --git a/en/OpenHarmony-Overview.md b/en/OpenHarmony-Overview.md index 8eec2fa3995f5dc504b78e3767da0834bf832be3..f1d91c098355f5cddc6f0d77cd1b0ddeda894791 100644 --- a/en/OpenHarmony-Overview.md +++ b/en/OpenHarmony-Overview.md @@ -1,5 +1,9 @@ # OpenHarmony Project +> **NOTE** +> +> You are reading documents of OpenHarmony 3.2 Beta5. You can use the [compatible SDK](../release-notes/OpenHarmony-v3.2-beta5.md#version-mapping) for your application development. + ## Introduction OpenHarmony is an open-source project incubated and operated by the OpenAtom Foundation. The purpose of this project is to build an open-source, distributed operating system (OS) framework for smart devices in all scenarios of a fully-connected world. diff --git a/en/application-dev/application-dev-guide.md b/en/application-dev/application-dev-guide.md index 3d81902230b7e115224d1ff4a02fed9279992bb4..57d32bd3263915f288dea29192136e903585b65c 100644 --- a/en/application-dev/application-dev-guide.md +++ b/en/application-dev/application-dev-guide.md @@ -1,5 +1,9 @@ # Application Development Overview +> **NOTE** +> +> You are reading documents of OpenHarmony 3.2 Beta5. You can use the [compatible SDK](../release-notes/OpenHarmony-v3.2-beta5.md#version-mapping) for your application development. + The application development documents provide reference for you to develop applications using the APIs provided by OpenHarmony. They walk you through how to use JavaScript APIs to develop applications on the standard system. The documents are carefully organized as follows: diff --git a/en/application-dev/application-models/Readme-EN.md b/en/application-dev/application-models/Readme-EN.md index f193a8bd10f532fb067bc22d3bf820820faf7592..5d58ed0a575d9ba5bd5bd31c1f13200ddbfc11f7 100644 --- a/en/application-dev/application-models/Readme-EN.md +++ b/en/application-dev/application-models/Readme-EN.md @@ -40,8 +40,8 @@ - [Introduction to Common Events](common-event-overview.md) - Common Event Subscription - [Common Event Subscription Overview](common-event-subscription-overview.md) - - [Subscribing to Dynamic Common Events](common-event-subscription.md) - - [Subscribing to Static Common Events (for System Applications Only)](common-event-static-subscription.md) + - [Subscribing to Common Events in Dynamic Mode](common-event-subscription.md) + - [Subscribing to Common Events in Static Mode (for System Applications Only)](common-event-static-subscription.md) - [Unsubscribing from Common Events](common-event-unsubscription.md) - [Publishing Common Events](common-event-publish.md) - [Background Services](background-services.md) diff --git a/en/application-dev/reference/apis/js-apis-medialibrary.md b/en/application-dev/reference/apis/js-apis-medialibrary.md index 240108ae1849dfb2fd04d927728c653cdb4627f7..634c81126559341206dbfd319d903c0a9bcd5c04 100644 --- a/en/application-dev/reference/apis/js-apis-medialibrary.md +++ b/en/application-dev/reference/apis/js-apis-medialibrary.md @@ -1,11 +1,8 @@ # @ohos.multimedia.medialibrary (Media Library Management) > **NOTE** -> -> - The APIs of this module are supported since API version 6. Updates will be marked with a superscript to indicate their earliest API version. -> - This API is deprecated since API version 9 and will be retained until API version 13. -> - Certain functionalities are changed as system APIs and can be used only by system applications. To use these functionalities, call [@ohos.filemanagement.userFileManager](js-apis-userFileManager.md). -> - The functionalities for selecting and storing media assets are still open to common applications. To use these functionalities, call [@ohos.file.picker](js-apis-file-picker.md). +> +> The APIs of this module are supported since API version 6. Updates will be marked with a superscript to indicate their earliest API version. ## Modules to Import ```js @@ -610,7 +607,7 @@ Call this API when you no longer need to use the APIs in the **MediaLibrary** in media.release() ``` -### storeMediaAsset +### storeMediaAsset(deprecated) storeMediaAsset(option: MediaAssetOption, callback: AsyncCallback<string>): void @@ -647,8 +644,7 @@ mediaLibrary.getMediaLibrary().storeMediaAsset(option, (error, value) => { }); ``` - -### storeMediaAsset +### storeMediaAsset(deprecated) storeMediaAsset(option: MediaAssetOption): Promise<string> @@ -689,7 +685,7 @@ mediaLibrary.getMediaLibrary().storeMediaAsset(option).then((value) => { ``` -### startImagePreview +### startImagePreview(deprecated) startImagePreview(images: Array<string>, index: number, callback: AsyncCallback<void>): void @@ -733,7 +729,7 @@ mediaLibrary.getMediaLibrary().startImagePreview(images, index, (error) => { ``` -### startImagePreview +### startImagePreview(deprecated) startImagePreview(images: Array<string>, callback: AsyncCallback<void>): void @@ -775,7 +771,7 @@ mediaLibrary.getMediaLibrary().startImagePreview(images, (error) => { ``` -### startImagePreview +### startImagePreview(deprecated) startImagePreview(images: Array<string>, index?: number): Promise<void> @@ -822,7 +818,7 @@ mediaLibrary.getMediaLibrary().startImagePreview(images, index).then(() => { ``` -### startMediaSelect +### startMediaSelect(deprecated) startMediaSelect(option: MediaSelectOption, callback: AsyncCallback<Array<string>>): void @@ -859,7 +855,7 @@ mediaLibrary.getMediaLibrary().startMediaSelect(option, (error, value) => { ``` -### startMediaSelect +### startMediaSelect(deprecated) startMediaSelect(option: MediaSelectOption): Promise<Array<string>> @@ -2634,12 +2630,15 @@ Describes the image size. | width | number | Yes | Yes | Image width, in pixels.| | height | number | Yes | Yes | Image height, in pixels.| -## MediaAssetOption +## MediaAssetOption(deprecated) Implements the media asset option. -**System capability**: SystemCapability.Multimedia.MediaLibrary.Core +> **NOTE** +> +> This API is deprecated since API version 9. +**System capability**: SystemCapability.Multimedia.MediaLibrary.Core | Name | Type | Readable| Writable| Description | | ------------ | ------ | ---- | ---- | ------------------------------------------------------------ | @@ -2647,12 +2646,15 @@ Implements the media asset option. | mimeType | string | Yes | Yes | Multipurpose Internet Mail Extensions (MIME) type of the media.
The value can be 'image/\*', 'video/\*', 'audio/\*' or 'file\*'.| | relativePath | string | Yes | Yes | Custom path for storing media assets, for example, 'Pictures/'. If this parameter is unspecified, media assets are stored in the default path.
Default path of images: 'Pictures/'
Default path of videos: 'Videos/'
Default path of audios: 'Audios/'
Default path of files: 'Documents/'| -## MediaSelectOption +## MediaSelectOption(deprecated) Describes media selection option. -**System capability**: SystemCapability.Multimedia.MediaLibrary.Core +> **NOTE** +> +> This API is deprecated since API version 9. +**System capability**: SystemCapability.Multimedia.MediaLibrary.Core | Name | Type | Readable| Writable| Description | | ----- | ------ | ---- | ---- | -------------------- | | type | 'image' | 'video' | 'media' | Yes | Yes | Media type, which can be **image**, **media**, or **video**. Currently, only **media** is supported.| diff --git a/en/application-dev/website.md b/en/application-dev/website.md index bed8f0d21ff4afc8afe69ca4a8b217c448080ba7..a9f030a61bbd3d8d12387e62a95d7c86ef1ef50b 100644 --- a/en/application-dev/website.md +++ b/en/application-dev/website.md @@ -21,6 +21,10 @@ - [Multi-HAP Usage Rules](quick-start/multi-hap-rules.md) - [Multi-HAP Operation Mechanism and Data Communication Modes](quick-start/multi-hap-principles.md) - [Application Installation and Uninstallation Process](quick-start/application-package-install-uninstall.md) + - [Application Package Update Process](quick-start/application-package-update.md) + - Quick Fix + - [Quick Fix Overview](quick-start/quickfix-principles.md) + - [CLI-based Quick Fix Development](quick-start/quickfix-debug.md) - Application Configuration Files in Stage Model - [Application Configuration File Overview (Stage Model)](quick-start/application-configuration-file-overview-stage.md) - [app.json5 Configuration File](quick-start/app-configuration-file.md) @@ -63,6 +67,7 @@ - [ServiceExtensionAbility](application-models/serviceextensionability.md) - [DataShareExtensionAbility (for System Applications Only)](application-models/datashareextensionability.md) - [FormExtensionAbility (Widget)](application-models/widget-development-stage.md) + - [EnterpriseAdminExtensionAbility](application-models/enterprise-extensionAbility.md) - [AbilityStage Component Container](application-models/abilitystage.md) - [Context](application-models/application-context-stage.md) - Want @@ -81,9 +86,12 @@ - [Process Model](application-models/process-model-stage.md) - Common Events - [Introduction to Common Events](application-models/common-event-overview.md) - - [Subscribing to Common Events](application-models/common-event-subscription.md) + - Common Event Subscription + - [Common Event Subscription Overview](application-models/common-event-subscription-overview.md) + - [Subscribing to Common Events in Dynamic Mode](application-models/common-event-subscription.md) + - [Subscribing to Common Events in Static Mode (for System Applications Only)](application-models/common-event-static-subscription.md) + - [Unsubscribing from Common Events](application-models/common-event-unsubscription.md) - [Publishing Common Events](application-models/common-event-publish.md) - - [Unsubscribing from Common Events](application-models/common-event-unsubscription.md) - [Background Services](application-models/background-services.md) - Inter-Thread Communication - [Thread Model](application-models/thread-model-stage.md) diff --git a/en/release-notes/OpenHarmony-v3.2-beta5.md b/en/release-notes/OpenHarmony-v3.2-beta5.md index 0598fb7f13750d0d1ecc2fc49bf48817cdd24056..72cd2f7dd4056610cda61b1f6acfbf98b1f15fab 100644 --- a/en/release-notes/OpenHarmony-v3.2-beta5.md +++ b/en/release-notes/OpenHarmony-v3.2-beta5.md @@ -45,9 +45,9 @@ BLE connection parameters can be configured, and the connection process is optim | Software/Tool| Version| Remarks| | -------- | -------- | -------- | | OpenHarmony | 3.2 Beta5 | NA | -| Public SDK | Ohos_sdk_public 3.2.10.6 (API Version 9 Beta5) | This toolkit is intended for application developers and does not contain system APIs that require system permissions. It is provided as standard in DevEco Studio.| -| (Optional) HUAWEI DevEco Studio| *To be released*| Recommended for developing OpenHarmony applications| -| (Optional) HUAWEI DevEco Device Tool| *To be released*| Recommended for developing OpenHarmony smart devices| +| Public SDK | Ohos_sdk_public 3.2.10.6 (API Version 9 Beta5) | This toolkit is intended for application developers and does not contain system APIs that require system permissions.
It is provided as standard in DevEco Studio.| +| (Optional) HUAWEI DevEco Studio| 3.1 Beta1 | Recommended for developing OpenHarmony applications | +| (Optional) HUAWEI DevEco Device Tool| 3.1 Beta2 | Recommended for developing OpenHarmony smart devices | ## Source Code Acquisition @@ -137,9 +137,9 @@ This version has the following updates to OpenHarmony 3.2 Beta4. ### SDK Updates -From this version, only the public SDK is released. You can obtain the public SDK from the mirror or download it through DevEco Studio. +From this version on, only the public SDK is released. You can obtain the public SDK from the mirror or download it from DevEco Studio for your application development. -To use the full SDK that contains the system APIs, you must download the full source code, build a SDK file, and switch to the full SDK on DevEco Studio. For details, see [Guide to Building Full SDK](../application-dev/quick-start/full-sdk-compile-guide.md). +To use the full SDK that contains system APIs, you must download the full code, compile and build an SDK file, and switch to the full SDK on DevEco Studio. For details about how to compile the full SDK using the source code, see [Full SDK Compilation Guide](../application-dev/quick-start/full-sdk-compile-guide.md). ### Feature Updates @@ -162,11 +162,13 @@ To use the full SDK that contains the system APIs, you must download the full so | File storage| - Unified URI processing is added for application files.
- Temporary authorization and unified open entry are added for user data.
The following requirements are involved:
I687C8 [New capability] Unified URI processing for application files
I64U8W [Basic capability] Temporary authorization and unified open entry for user data| NA | | Ability framework| - The restart of resident processes is optimized.
- The widget database can be switched.
- The asynchronous **onConnected** lifecycle is provided.
The following requirements are involved:
I65M3F [Basic capability] ShellCommand execution control
I65V83 [Basic capability] ServiceExtensionAbility support for asynchronous **onConnected** lifecycle
I61H21 [Basic capability] Change of the local widget database
I63UJ5 [Ability] [ability_runtime] Exception handling in API version 8 and earlier versions
I6BDCW [Basic capability] Forbidden to load code in the **data** directory during application loading
I6BDDU [Basic capability] Default ability launch mode of the FA model: Standard
I6BDE2 [Basic capability] Protection against frequent restart of resident applications| NA | -For details on the API difference list, see [API Differences](api-change/v3.2-beta5/Readme-EN.md). +For details about the API changes, see [API Differences](api-change/v3.2-beta5/Readme-EN.md). + +For details about the API changes of each subsystem, see [Changelogs](changelogs/v3.2-beta5/Readme-EN.md). -For details about the API differences of each subsystem, see [Changelogs](changelogs/v3.2-beta5/Readme-EN.md) ### Chip and Development Board Adaptation + For details about the adaptation status, see [SIG-Devboard](https://gitee.com/openharmony/community/blob/master/sig/sig-devboard/sig_devboard.md). @@ -177,9 +179,9 @@ For details about the adaptation status, see [SIG-Devboard](https://gitee.com/op | Subsystem| Name| Introduction| Programming Language| | -------- | -------- | -------- | -------- | | Multimedia subsystem| [QR code scanning](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-3.2-Beta5/media/Scan)| The sample app is used to scan QR code. With the app, you can select a QR code image from a folder to identify the QR code information.| ArkTS| -| ArkUI | [Home Page of the Application Market](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-3.2-Beta5/MultiDeviceAppDev/AppMarket) | This sample shows a typical home page of the application market. The page has different display effects in the small window and large window, reflecting the capability of one-time development for multi-device deployment.| ArkTS| +| ArkUI | [Home Page of the Application Market](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-3.2-Beta5/MultiDeviceAppDev/AppMarket)| This sample shows the home page of the application market. The page has different display effects in the small window and large window, reflecting the capability of one-time development for multi-device deployment.| ArkTS| | File management subsystem| [File Management](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-3.2-Beta5/FileManager/FileIo)| This sample demonstrates file management. It uses the [mediaLibrary](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md), [userFileManager](https://gitee.com/openharmony/docs/blob/master/en/application-dev/reference/apis/js-apis-userfilemanager.md) and [fileio](https://gitee.com/openharmony/docs/blob/master/en/application-dev/reference/apis/js-apis-fileio.md) APIs to add and access media library files and files in the application sandbox.| ArkTS| -| Ability framework| [Gallery Widget](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-3.2-Beta5/ability/GalleryForm) | This sample app is a gallery widget. It demonstrates how a photo in the gallery is displayed in the widget and how the widget content is periodically updated. | ArkTS| +| Ability framework| [Gallery Widget](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-3.2-Beta5/ability/GalleryForm)| This sample demonstrates the display of **Gallery** images in a widget and periodic update of the widget.| ArkTS| For more information, visit [Samples](https://gitee.com/openharmony/applications_app_samples).