更多内容请访问：与华为官方共建的鸿蒙技术社区https://ost.51cto.com概述本文主要介绍基于OpenHarmony3.1Beta版的软通动力扬帆智能开发套件软件开发环境的搭建，指导如何进行应用开发。目标读者本文档适用于从事OpenHarmony应用软件的开发人员。对象要求?开发者需要按照文档章节顺序搭建扬帆软件开发环境。版权声明本文档的版权归软通动力信息技术（集团）有限公司所有，保留所有权利。本文档内容未经许可不得复制或转载。修订记录本文档的内容会随着技术的发展而更新。修订记录如下：版本：V1.0更新说明：第1版发布修改日期：2022.02.20一、环境要求电脑要求Windows版本：Windows10、64位内存：8GB以上硬盘：100GB以上分辨率:1280*800pixelsandabove2.应用开发指导前提条件单板启动正常运行步骤第一步：安装DevEcoStudio3.0Beta1及以上版本。下载地址：https://developer.harmonyos.com/cn/develop/deveco-studio#download第二步：配置OpenHarmonySDK。运行安装好的DevEcoStudio，首次使用请选择Donotimportsettings，点击OK。进入配置向导页面，设置npmregistry，DevEcoStudio已经预置了对应的仓库，直接点击StartusingDevEcoStudio进入下一步。DevEcoStudio向导引导开发者下载SDK，默认下载OpenHarmonySDK。SDK下载到用户目录下，也可以指定对应的存放路径。SDK存放路径不支持汉字，点击下一步。在弹出的SDK下载信息页面点击下一步，在弹出的许可协议窗口点击接受开始下载SDK。等待OpenHarmonySDK和工具下载完成，点击Finish，界面会进入DevEcoStudio欢迎页面。配置好OpenHarmonySDK后，下一步就是创建一个OpenHarmony项目。第3步：创建一个openharmony项目。使用以下两种方式打开项目创建向导界面。如果当前没有打开项目，可以在DevEcoStudio欢迎页面选择CreateProject开始创建新项目。如果项目已经打开，您可以从菜单栏中选择“文件”>“新建”>“新建项目”来创建一个新项目。根据项目创建向导，选择“[Standard]EmptyAbility”模板，点击下一步。点击下一步进入项目配置阶段，需要根据向导配置项目的基本信息。项目名称：项目名称，可自定义。项目类型：项目的类型，标识该项目是原子服务（Service）还是传统方式需要安装的应用程序（Application）。包名称：包名称。默认情况下，应用程序ID也将使用此名称。应用发布时，应用ID需要是唯一的。如果“ProjectType”选择了AtomicService，则BundleName的后缀必须是.hmservice。保存位置：项目文件的本地存储路径。开发模式：选择开发模式，部分模板支持低代码开发，可以选择SuperVisual。语言：支持的开发语言。兼容的API版本：最低兼容的SDK版本。设备类型：此项目模板支持的设备类型。点击完成，工具会自动生成示例代码和相关资源，等待项目创建完成。第四步：配置应用签名信息。在使用真实设备运行和调试OpenHarmony应用程序之前，需要对应用程序进行签名才能正常运行。1.生成密钥和证书请求文件。OpenHarmony应用程序使用数字证书（.cer文件）和配置文件(.p7b)来确保应用程序的完整性。DevEcoStudio需要生成密钥文件（.p12文件）和证书请求。该文件（.csr文件）是使用DevEcoStudio生成的。单击主菜单栏上的构建>生成密钥和CSR。注意：如果本地已经有对应的key，不需要生成新的key，可以点击GenerateKey界面下方的Skip，跳过生成key的过程，直接使用已有的key生成证书请求文件。在KeyStoreFile中，可以点击ChooseExisting选择一个已经存在的keystore文件（存放密钥的.p12文件）；如果没有密钥库文件，请单击“新建”创建它。下面以新建的keystore文件为例进行说明。oKeyStoreFile：选择keystore文件存放路径。密码：设置keystore密码，密码必须为大写字母、小写字母、数字和特殊符号中两个或两个以上字符的组合，长度至少为8个字符。请记住此密码，后续签名配置时会用到。确认密码：再次输入密钥库密码。Alias：密钥的别名信息，用于标识密钥名称。请记住这个别名，您将需要使用它来进行后续的签名配置。Password：key对应的密码，与keystore密码一致，不需要手动输入。有效期：证书的有效期。建议设置为25年或以上，覆盖应用/服务的整个生命周期。证书：填写证书的基本信息，如组织、城市或地区、国家代码等。在生成密钥界面，继续填写密钥信息后，点击下一步。在生成CSR界面，选择一个key，设置CSR文件的存放路径。点击确定按钮，CSR文件创建成功，在存储路径下可以得到生成的keystore文件（.p12）和证书请求文件（.csr）。2.生成应用证书文件使用生成密钥和证书请求文件中生成的证书请求文件生成应用签名所需的数字证书文件。生成方法如下：进入DevEcoStudio安装目录的Sdk\toolchains\lib文件夹（SDK目录只能是OpenHarmonySDK，配置方法可参考ConfiguringtheOpenHarmonySDK），打开命令行工具，并执行以下命令（如果keytool命令无法执行，请在系统环境变量中添加JDK环境变量）。其中，只需要修改输入输出即可快速生成证书文件，即修改**-infile指定证书申请文件csr文件的路径，修改-outfile**指定名称和路径输出证书文件。keytool-gencert-alias"OpenHarmonyApplicationCA"-infilemyApplication_ohos.csr-outfilemyApplication_ohos.cer-keystoreOpenHarmony.p12-sigalgSHA384withECDSA-storepass123456-extKeyUsage:"critical=digitalSignature"-validity3650-rfcabout描述如下如下：alias：用于颁发证书的CA私钥的别名。OpenHarmony社区CA私钥存储在OpenHarmony.p12密钥库文件中。该参数不能修改。infile：证书请求(CSR)文件的路径。outfile：输出证书链文件名和路径。keystore：颁发证书的CAkeystore的路径。OpenHarmony密钥库文件名为OpenHarmony.p12。该文件位于OpenHarmonySDK的Sdk\toolchains\lib路径下。该参数不能修改。请注意，OpenHarmony.p12文件不是生成密钥和证书请求文件中生成的.p12文件。sigalg：证书签名算法，该参数不可修改。storepass：Keystore密码，密码为123456，该参数不可修改。ext：证书扩展名，该参数不可修改。validity：证书的有效期，天数可以自定义。rfc：指定输出文件格式，该参数不可修改。3.生成应用配置文件。配置文件包含OpenHarmony应用的包名、数字证书信息、描述允许应用申请的证书权限列表、允许应用调试的设备列表（如果应用类型为Release类型，设备列表为空）等内容，每个应用包必须包含一个Profile文件。进入Sdk\toolchains\lib目录，打开命令行工具，执行以下命令。java-jarprovisionsigtool.jarsign--inUnsgnedReleasedProfileTemplate.json--outmyApplication_ohos_Provision.p7b--keystoreOpenHarmony.p12--storepass123456--alias"OpenHarmonyApplicationProfileRelease"--sigAlgSHA256withECDSA--certOpenHarmonyPropemfileRelease。validity365--developer-idohosdeveloper--bundle-name包名--permissionrestricted权限名（可选）--permissionrestricted权限名（可选）--distribution-certificatemyApplication_ohos.cer关于该命令的参数说明如下:oprovisionsigtool：Profile文件生成工具，文件在OpenHarmonySDK的Sdk\toolchains\lib路径下。in：Profile模板文件所在路径。该文件在OpenHarmonySDK中的Sdk\toolchains\lib路径下。该参数不能修改。out：输出配置文件的文件名和路径。keystore：颁发证书的keystore路径。OpenHarmony密钥库文件名为OpenHarmony.p12。该文件在OpenHarmonySDK的Sdk\toolchains\lib路径下。该参数不能修改。storepass：Keystore密码，密码为123456，该参数不可修改。alias：用于签署profile私钥别名，OpenHarmony社区CA私钥保存在OpenHarmony.p12keystore文件中，该参数不可修改。sigalg：证书签名算法，该参数不可修改。cert：签名配置文件的证书文件路径。该文件在OpenHarmonySDK中的Sdk\toolchains\lib路径下。该参数不能修改。validity：证书的有效期，天数可以自定义。developer-id：开发者标识符，自定义字符串。bundle-name：填写应用包名。权限：可选字段，如果不需要，可以将此字段留空；如果您需要添加多个受限权限，请按照示例所示重复输入。限制权限列表如下：ohos.permission.READ_CONTACTS,ohos.permission.WRITE_CONTACTS。distribution-certificate：生成ApplicationCertificateFile中生成的证书文件。4.配置应用程序签名信息在真机调试前，需要使用生成的私钥（.p12）文件、证书（.cer）文件和Profile（.p7b）文件对被调试模块进行签名。打开File>ProjectStructure，点击Project>SigningConfigs>debugwindow，取消勾选Automaticallygeneratesigning，然后配置指定模块的调试签名信息。StoreFile：选择密钥存储文件，文件后缀为.p12，即GenerateKeyandCertificateRequestFile中生成的.p12文件。StorePassword：输入密钥库密码，与生成的密钥和证书请求文件中填写的密钥库密码相同。密钥别名：填写密钥的别名信息，与生成的密钥和证书申请文件填写的别名一致。KeyPassword：输入密钥的密码，与StorePassword一致。SignAlg：签名算法，固定为SHA256withECDSA。ProfileFile：选择GenerateApplicationProfileFile中生成的profile文件，文件后缀为.p7b。CertpathFile：选择GenerateApplicationCertificateFile中生成的数字证书文件，文件后缀为.cer。签名信息设置完成后点击确定保存，即可在项目下的build.gradle中查看签名配置信息。默认情况下，DevEcoStudio编译的hap包类型为debug类型。如果需要编译release类型的hap包，请打开项目左下角的OhosBuildVariants，将模块的编译构建类型设置为release。hap的详细编译构建请参考《HUAWEIDevEcoStudio用户指南》。编译完成后，可以在项目的bulid目录下获取OpenHarmony应用的Hap包。第5步：安装并运行应用程序。使用hdc工具将编译好的本地hap包安装到板子上。安装命令install[-r/-d/-g]package命令示例：hdcinstallE:\entry-debug-rich-signed.hap说明：蓝色表示要安装的hap包的本地路径。?Uninstall命令uninstall[-k]package命令示例：hdcuninstallcom.example.relayapplication.hmservice说明：蓝色表示hap包的bundleName。点击触摸屏上的Hap图标或使用命令启动Hap包。aastart-dl-amainAbility-bbundleName，其中mainAbility和bundleName替换为自己开发的应用的名称（可以在应用项目的config.json文件中找到）。出现以下打印表示应用启动成功：更多信息请访问：鸿蒙科技社区，与华为官方共建https://ost.51cto.com
