diff --git "a/zh-cn/application-dev/quick-start/DevEco-Studio\357\274\210OpenHarmony\357\274\211\344\275\277\347\224\250\346\214\207\345\215\227.md" "b/zh-cn/application-dev/quick-start/DevEco-Studio\357\274\210OpenHarmony\357\274\211\344\275\277\347\224\250\346\214\207\345\215\227.md" index 3b65fa9abb836843cef657deb210f8515c984542..e6197342ac3d774849033892b4d98f71b62715c4 100644 --- "a/zh-cn/application-dev/quick-start/DevEco-Studio\357\274\210OpenHarmony\357\274\211\344\275\277\347\224\250\346\214\207\345\215\227.md" +++ "b/zh-cn/application-dev/quick-start/DevEco-Studio\357\274\210OpenHarmony\357\274\211\344\275\277\347\224\250\346\214\207\345\215\227.md" @@ -4,7 +4,7 @@ - **[配置OpenHarmony SDK](配置OpenHarmony-SDK.md)** -- **[导入OpenHarmony工程](导入OpenHarmony工程.md)** +- **[创建OpenHarmony工程](创建OpenHarmony工程.md)** - **[配置OpenHarmony应用签名信息](配置OpenHarmony应用签名信息.md)** diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001118201202.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001118201202.png new file mode 100644 index 0000000000000000000000000000000000000000..13231431d0fa268058df97a0187837c634052fa6 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001118201202.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001130932554.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001130932554.png new file mode 100644 index 0000000000000000000000000000000000000000..0628bd691b40a53e0e5ac919381b13131587a10a Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001130932554.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001165463605.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001165463605.png new file mode 100644 index 0000000000000000000000000000000000000000..4d57c412c582e1dfb3e28fc2fd13de1d235b73de Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001165463605.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001177051523.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001177051523.png new file mode 100644 index 0000000000000000000000000000000000000000..1b4cbd9b48873812575675d3029208ebdb3d0161 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001177051523.png differ diff --git "a/zh-cn/application-dev/quick-start/\345\210\233\345\273\272OpenHarmony\345\267\245\347\250\213.md" "b/zh-cn/application-dev/quick-start/\345\210\233\345\273\272OpenHarmony\345\267\245\347\250\213.md" new file mode 100644 index 0000000000000000000000000000000000000000..f50abfee7407382c06751a98f66f50ed38c79f77 --- /dev/null +++ "b/zh-cn/application-dev/quick-start/\345\210\233\345\273\272OpenHarmony\345\267\245\347\250\213.md" @@ -0,0 +1,7 @@ +# 创建OpenHarmony工程 + +- **[创新新工程](创新新工程.md)** + +- **[导入OpenHarmony工程](导入OpenHarmony工程.md)** + + diff --git "a/zh-cn/application-dev/quick-start/\345\210\233\345\273\272\346\226\260\345\267\245\347\250\213.md" "b/zh-cn/application-dev/quick-start/\345\210\233\345\273\272\346\226\260\345\267\245\347\250\213.md" new file mode 100644 index 0000000000000000000000000000000000000000..299ae484cb2a23179c97bf61277a079db9fde1a6 --- /dev/null +++ "b/zh-cn/application-dev/quick-start/\345\210\233\345\273\272\346\226\260\345\267\245\347\250\213.md" @@ -0,0 +1,42 @@ +# 创建新工程 + +- [前提条件](#section13642104391619) +- [操作步骤](#section132671712101714) + +创建一个OpenHarmony工程，该功能只有DevEco Studio 2.2 Beta1及以上版本支持。如果是DevEco Studio 2.1 Release版本，请根据[导入OpenHarmony工程](导入OpenHarmony工程.md)进行操作。 + +## 前提条件 + +已安装OpenHarmony SDK，具体请参考[配置OpenHarmony SDK](配置OpenHarmony-SDK.md)。 + +## 操作步骤 + +1. 通过如下两种方式，打开工程创建向导界面。 + - 如果当前未打开任何工程，可以在DevEco Studio的欢迎页，选择**Create HarmonyOS Project**开始创建一个新工程。 + - 如果已经打开了工程，可以在菜单栏选择**File \> New \> New Project**来创建一个新工程。 + +2. 根据工程创建向导，选择**\[Standard\]Empty Ability\(JS\)**模板，点击**Next**。 + + ![](figures/zh-cn_image_0000001177051523.png) + +3. 点击**Next**，进入到工程配置阶段，需要根据向导配置工程的基本信息。 + - **Project Name**：工程的名称，可以自定义。 + - **Project Type：**工程的类型，标识该工程是一个[原子化服务](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/atomic-service-definition-0000001090840664)（Service）或传统方式的需要安装的应用（Application）。 + + >![](public_sys-resources/icon-note.gif) **说明：** + >如果是创建的原子化服务，则： + >- 原子化服务调试、运行时，在设备桌面上没有应用图标，请使用DevEco Studio的调试和运行功能，来启动原子化服务。 + >- 原子化服务是免安装的，config.json中自动添加**installationFree**字段，取值为“true”。 + >- 如果entry模块的**installationFree**字段为true，则其相关的所有hap模块的**installationFree**字段都默认为true；如果entry模块的**installationFree**字段为false，则其相关的所有hap模块可以配置为true或false。 + >- 编译构建App时，每个hap包大小不能超过10MB。 + + - **Package Name**：软件包名称，默认情况下，应用ID也会使用该名称，应用发布时，应用ID需要唯一。 + - **Save Location**：工程文件本地存储路径。 + - **Compatible API Version**：兼容的SDK最低版本。 + - **Device Type：**该工程模板支持的设备类型。 + + ![](figures/zh-cn_image_0000001130932554.png) + + +4. 点击**Finish**，工具会自动生成示例代码和相关资源，等待工程创建完成。 + diff --git "a/zh-cn/application-dev/quick-start/\345\257\274\345\205\245OpenHarmony\345\267\245\347\250\213.md" "b/zh-cn/application-dev/quick-start/\345\257\274\345\205\245OpenHarmony\345\267\245\347\250\213.md" index c218afd2e57f903ec6510354d8298b0307f227ee..13f301a827ffd16f970948f47f5fc079ad0fcdb2 100644 --- "a/zh-cn/application-dev/quick-start/\345\257\274\345\205\245OpenHarmony\345\267\245\347\250\213.md" +++ "b/zh-cn/application-dev/quick-start/\345\257\274\345\205\245OpenHarmony\345\267\245\347\250\213.md" @@ -1,9 +1,13 @@ # 导入OpenHarmony工程 +>![](public_sys-resources/icon-note.gif) **说明：** +>该功能适用于通过DevEco Studio 2.1 Release及以上版本，创建OpenHarmony工程。 + OpenHarmony SDK配置完成后，便可以启动应用开发。针对OpenHarmony应用开发，**只能通过导入Sample工程的方式来创建一个新工程**。 -目前，支持OpenHarmony应用开发的Sample工程，请选择导入含有“ **This sample is intended for novices at developing OpenHarmony applications.** ”说明的Sample，例如选择common分类中的**HelloWorld**或者**JsHelloWorld**。 -![输入图片说明](https://images.gitee.com/uploads/images/2021/0607/153103_bf8ef3b1_8698404.png "unnaming (26).png") +目前，支持OpenHarmony应用开发的Sample工程，请选择导入含有“**This sample is intended for novices at developing OpenHarmony applications.**”说明的Sample，例如选择common分类中的**JsHelloWorld**。 + +![](figures/zh-cn_image_0000001165463605.png) 1. 在DevEco Studio的欢迎页，进入**Configure （或**![](figures/zh-cn_image_0000001118018452.png)**图标） \> Settings \> Version Control \> Git**界面，点击Test按钮检测是否安装Git工具。 - 已安装，请根据[2](#li5947194711181)开始导入Sample。 @@ -21,7 +25,7 @@ OpenHarmony SDK配置完成后，便可以启动应用开发。针对OpenHarmony 3. 选择common下的**JsHelloWorld**工程，然后点击**Next**。 - ![输入图片说明](https://images.gitee.com/uploads/images/2021/0607/153157_a61135ee_8698404.png "unnaming (27).png") + ![](figures/zh-cn_image_0000001118201202.png) 4. 设置**App Name**和**Project Location**，然后点击**Finish**，等待Sample工程导入完成。 diff --git "a/zh-cn/application-dev/quick-start/\346\246\202\350\277\260.md" "b/zh-cn/application-dev/quick-start/\346\246\202\350\277\260.md" index 47ec5f7d059593c1b2eb9a16319af06117e86468..4726ab655e4b85c94c65e969bb0f674ede355e2d 100644 --- "a/zh-cn/application-dev/quick-start/\346\246\202\350\277\260.md" +++ "b/zh-cn/application-dev/quick-start/\346\246\202\350\277\260.md" @@ -22,7 +22,7 @@ DevEco Studio是HarmonyOS的配套的开发IDE，因为HarmonyOS是基于OpenHar - OpenHarmony只支持使用JS语言开发应用，不支持Java、C/C++语言。 - OpenHarmony开发环境DevEco Studio暂只支持Windows系统。 -OpenHarmony与HarmonyOS的开发工具都是DevEco Studio，下表为OpenHarmony与HarmonyOS的IDE功能差异说明： +OpenHarmony与HarmonyOS的开发工具都是DevEco Studio，下表为OpenHarmony相比HarmonyOS不支持的功能说明：

特性名称

diff --git "a/zh-cn/application-dev/quick-start/\351\205\215\347\275\256OpenHarmony-SDK.md" "b/zh-cn/application-dev/quick-start/\351\205\215\347\275\256OpenHarmony-SDK.md" index bcb326f7ddbe103fbf5b7d0ad479897e7cd3186e..5bc89c405428aca3c30ea5552456d2c024658152 100644 --- "a/zh-cn/application-dev/quick-start/\351\205\215\347\275\256OpenHarmony-SDK.md" +++ "b/zh-cn/application-dev/quick-start/\351\205\215\347\275\256OpenHarmony-SDK.md" @@ -10,7 +10,7 @@ ## 前提条件 -- 已下载并安装好DevEco Studio 2.1 Release，点击[链接下载](https://developer.harmonyos.com/cn/develop/deveco-studio#download)。 +- 已下载并安装好DevEco Studio 2.1 Release及以上版本，点击[链接下载](https://developer.harmonyos.com/cn/develop/deveco-studio#download)。 - 已获取OpenHarmony SDK包并解压，点击[链接下载](https://mirror.iscas.ac.cn/OpenHarmony/sdk/OpenHarmony-SDK-2.0-Canary.7z)。 ## 配置SDK信息 diff --git "a/zh-cn/application-dev/quick-start/\351\205\215\347\275\256OpenHarmony\345\272\224\347\224\250\347\255\276\345\220\215\344\277\241\346\201\257.md" "b/zh-cn/application-dev/quick-start/\351\205\215\347\275\256OpenHarmony\345\272\224\347\224\250\347\255\276\345\220\215\344\277\241\346\201\257.md" index 3989191cb2886bee7613594d2a68e3d1da698b3b..7e869099840cf733fbd3875af19373158573ff5b 100644 --- "a/zh-cn/application-dev/quick-start/\351\205\215\347\275\256OpenHarmony\345\272\224\347\224\250\347\255\276\345\220\215\344\277\241\346\201\257.md" +++ "b/zh-cn/application-dev/quick-start/\351\205\215\347\275\256OpenHarmony\345\272\224\347\224\250\347\255\276\345\220\215\344\277\241\346\201\257.md" @@ -11,21 +11,18 @@ ## 生成密钥和证书请求文件 -OpenHarmony应用通过数字证书（.cer文件）和Profile文件（.p7b文件）来保证应用的完整性，需要通过DevEco Studio来生成密钥文件（.p12文件）和证书请求文件（.csr文件）。同时，也可以使用命令行工具的方式来生成密钥文件和证书请求文件。具体操作请参考[生成密钥和证书请求文件](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ide_debug_device-0000001053822404#ZH-CN_TOPIC_0000001154985555__section837891802519)。 +OpenHarmony应用通过数字证书（.cer文件）和Profile文件（.p7b文件）来保证应用的完整性，需要通过DevEco Studio来生成密钥文件（.p12文件）和证书请求文件（.csr文件）。同时，也可以使用命令行工具的方式来生成密钥文件和证书请求文件。具体操作请参考[生成密钥和证书请求文件](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section9752152162813)。 ## 生成应用证书文件 使用[生成密钥和证书请求文件](#section153146467405)中生成的证书请求文件，来生成应用签名所需的数字证书文件。生成方法如下： -进入DevEco Studio安装目录的**Sdk\\toolchains\\lib**文件夹下，打开命令行工具，执行如下命令（如果keytool命令不能执行，请在系统环境变量中添加JDK的环境变量）。其中，只需要修改输入和输出即可快速生成证书文件，即修改**-infile**指定证书请求文件csr文件路径，**-outfile**指定输出证书文件名及路径。 +进入DevEco Studio安装目录的**Sdk\\toolchains\\lib**文件夹下（该SDK目录只能是OpenHarmony SDK，配置方法可参考[配置OpenHarmony SDK](配置OpenHarmony-SDK.md)），打开命令行工具，执行如下命令（如果keytool命令不能执行，请在系统环境变量中添加JDK的环境变量）。其中，只需要修改输入和输出即可快速生成证书文件，即修改**-infile**指定证书请求文件csr文件路径，**-outfile**指定输出证书文件名及路径。 ``` keytool -gencert -alias "OpenHarmony Application CA" -infile app.csr -outfile IDE.cer -keystore OpenHarmony.p12 -sigalg SHA384withECDSA -storepass 123456 -ext KeyUsage:"critical=digitalSignature" -validity 3650 -rfc ``` ->![](public_sys-resources/icon-note.gif) **说明：** ->在上述命令中，标识为蓝色字体的字段不能修改，否则会导致证书生成失败。 - 关于该命令的参数说明如下： - **alias**：用于签发证书的CA私钥别名，OpenHarmony社区CA私钥存于OpenHarmony.p12密钥库文件中，该参数不能修改。 @@ -48,9 +45,6 @@ Profile文件包含OpenHarmony应用的包名、数字证书信息、描述应 java -jar provisionsigtool.jar sign --in UnsgnedReleasedProfileTemplate.json --out SgnedReleasedProfileTemplate.p7b --keystore OpenHarmony.p12 --storepass 123456 --alias "OpenHarmony Application Profile Release" --sigAlg SHA256withECDSA --cert OpenHarmonyProfileRelease.pem --validity 365 --developer-id ohosdeveloper --bundle-name 包名 --permission 受限权限名（可选） --permission 受限权限名（可选） --distribution-certificate IDE.cer ``` ->![](public_sys-resources/icon-note.gif) **说明：** ->在上述命令中，标识为蓝色字体的字段不能修改，否则会导致Profile文件生成失败。 - 关于该命令的参数说明如下： - **provisionsigtool**：Profile文件生成工具，文件在OpenHarmony SDK的**Sdk\\toolchains\\lib**路径下。