??想了解更多內(nèi)容，請(qǐng)?jiān)L問(wèn)：??

??51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)??

??https://ost.51cto.com??

概述

本文主要介紹基于OpenHarmony3.1Beta版本下軟通動(dòng)力揚(yáng)帆智能開發(fā)套件軟件開發(fā)環(huán)境的搭建，指導(dǎo)如何進(jìn)行應(yīng)用開發(fā)。

讀者對(duì)象

本文檔適用于從事OpenHarmony應(yīng)用軟件開發(fā)人員。

對(duì)象要求

?開發(fā)人員需按照文檔章節(jié)順序進(jìn)行揚(yáng)帆軟件開發(fā)環(huán)境搭建。

版權(quán)聲明

本文檔著作權(quán)由軟通動(dòng)力信息技術(shù)(集團(tuán))股份有限公司所有，保留一切權(quán)利。未經(jīng)許可不得擅自摘抄、復(fù)制本文檔內(nèi)容。

修訂記錄

本文檔內(nèi)容會(huì)隨著技術(shù)的發(fā)展進(jìn)行更新，修訂記錄如下:

• 版本:V1.0
• 更新說(shuō)明:第1版發(fā)布
• 修改日期:2022.02.20

一、環(huán)境搭建要求

計(jì)算機(jī)要求

• Windows版本：Windows 10，64位
• 內(nèi)存：8GB以上
• 硬盤：100GB以上
• 分辨率：1280*800像素及以上

工具介紹

本次軟件開發(fā)環(huán)境搭建所需工具如下：

工具準(zhǔn)備好的前提下，軟件環(huán)境搭建預(yù)計(jì)需要1小時(shí)左右。

二、應(yīng)用開發(fā)指導(dǎo)

前提條件

單板啟動(dòng)正常

操作步驟

第1步：安裝DevEco Studio 3.0 Beta1及以上版本。

下載鏈接：https://developer.harmonyos.com/cn/develop/deveco-studio#download

第2步：配置OpenHarmony SDK。

1. 運(yùn)行已安裝的DevEco Studio,首次使用，請(qǐng)選擇Do not import settings,點(diǎn)擊OK。
2. 進(jìn)入配置向?qū)ы?yè)面，設(shè)置npm registry, DevEco Studio 已預(yù)置對(duì)應(yīng)的倉(cāng)，直接點(diǎn)擊Start using DevEco Studio進(jìn)入下一步。
3. DevEco Studio向?qū)е敢_發(fā)者下載SDK,默認(rèn)下載OpenHarmony SDK。SDK下載到user目錄下，也可以指定對(duì)應(yīng)的存儲(chǔ)路徑，SDK存儲(chǔ)路徑不支持中文字符，然后點(diǎn)擊Next。
4. 在彈出的SDK下載信息頁(yè)面，點(diǎn)擊Next，并在彈出的License Agreement窗口，點(diǎn)擊Accept開始下載SDK。
5. 等待OpenHarmony SDK及工具下載完成，點(diǎn)擊Finish,界面會(huì)進(jìn)入到DevEco Studio歡迎頁(yè)。

配置完成OpenHarmony SDK后，下一步創(chuàng)建OpenHarmony工程。

第3步：創(chuàng)建openharmony工程。

通過(guò)如下兩種方式，打開工程創(chuàng)建向?qū)Ы缑妗?/p>

如果當(dāng)前未打開任何工程，可以在DevEco Studio的歡迎頁(yè)，選擇Create Project開始創(chuàng)建一個(gè)新工程。

如果已經(jīng)打開了工程，可以在菜單欄選擇File > New > New Project來(lái)創(chuàng)建一個(gè)新工程。

根據(jù)工程創(chuàng)建向?qū)Вx擇“[Standard]Empty Ability”模板，點(diǎn)擊Next。

點(diǎn)擊Next，進(jìn)入到工程配置階段，需要根據(jù)向?qū)渲霉こ痰幕拘畔ⅰ?/p>

• Project name：工程的名稱，可以自定義。
• Project type：工程的類型，標(biāo)識(shí)該工程是一個(gè)原子化服務(wù)(Service)或傳統(tǒng)方式的需要安裝的應(yīng)用(Application)。
• Bundle name：軟件包名稱，默認(rèn)情況下，應(yīng)用ID也會(huì)使用該名稱，應(yīng)用發(fā)布時(shí)，應(yīng)用ID需要唯一。如果“Project Type”選擇了Atomic Service，則Bundle Name的后綴名必須是.hmservice。
• Save Location：工程文件本地存儲(chǔ)路徑。
• Development mode：選擇開發(fā)模式，部分模板支持低代碼開發(fā)，可選擇Super Visual。
• ?Language：支持的開發(fā)語(yǔ)言。
• Compatible API Version：兼容的SDK最低版本。
• Device Type：該工程模板支持的設(shè)備類型。

點(diǎn)擊Finish，工具會(huì)自動(dòng)生成示例代碼和相關(guān)資源，等待工程創(chuàng)建完成。

第4步：配置應(yīng)用簽名信息。

使用真機(jī)設(shè)備運(yùn)行和調(diào)試OpenHarmony應(yīng)用前，需要對(duì)應(yīng)用進(jìn)行簽名才能正常運(yùn)行。

1、生成密鑰和證書請(qǐng)求文件

OpenHarmony應(yīng)用通過(guò)數(shù)字證書(.cer文件)和Profile文件(.p7b)來(lái)保證應(yīng)用的完整性，需要通過(guò)DevEco Studio來(lái)生成密鑰文件(.p12文件)和證書請(qǐng)求文件(.csr文件)

使用DevEco Studio生成。

在主菜單欄點(diǎn)擊Build > Generate Keyand CSR。

說(shuō)明： 如果本地已有對(duì)應(yīng)的密鑰，無(wú)需新生成密鑰，可以在Generate Key界面中點(diǎn)擊下方的Skip跳過(guò)密鑰生成過(guò)程，直接使用已有密鑰生成證書請(qǐng)求文件。

在Key Store File中，可以點(diǎn)擊Choose Existing選擇已有的密鑰庫(kù)文件(存儲(chǔ)有密鑰的.p12文件);如果沒(méi)有密鑰庫(kù)文件，點(diǎn)擊New進(jìn)行創(chuàng)建。下面以新創(chuàng)建密鑰庫(kù)文件為例進(jìn)行說(shuō)明。

• oKey Store File：選擇密鑰庫(kù)文件存儲(chǔ)路徑。
• Password：設(shè)置密鑰庫(kù)密碼，必須由大寫字母、小寫字母、數(shù)字和特殊符號(hào)中的兩種以上字符的組合，長(zhǎng)度至少為8位。請(qǐng)記住該密碼，后續(xù)簽名配置需要使用。
• Confirm Password：再次輸入密鑰庫(kù)密碼。

• Alias：密鑰的別名信息，用于標(biāo)識(shí)密鑰名稱。請(qǐng)記住該別名，后續(xù)簽名配置需要使用。
• Password：密鑰對(duì)應(yīng)的密碼，與密鑰庫(kù)密碼保持一致，無(wú)需手動(dòng)輸入。
• Validity：證書有效期，建議設(shè)置為25年及以上，覆蓋應(yīng)用/服務(wù)的完整生命周期。
• Certificate：輸入證書基本信息，如組織、城市或地區(qū)、國(guó)家碼等。

在Generate Key界面中，繼續(xù)填寫密鑰信息后，點(diǎn)擊Next。

在Generate CSR界面，選擇密鑰和設(shè)置CSR文件存儲(chǔ)路徑。

點(diǎn)擊OK按鈕，創(chuàng)建CSR文件成功，可以在存儲(chǔ)路徑下獲取生成的密鑰庫(kù)文件(.p12)和證書請(qǐng)求文件(.csr)。

2、生成應(yīng)用證書文件

使用生成密鑰和證書請(qǐng)求文件中生成的證書請(qǐng)求文件，來(lái)生成應(yīng)用簽名所需的數(shù)字證書文件。生成方法如下：

進(jìn)入DevEco Studio安裝目錄的Sdk\toolchains\lib文件夾下(該SDK目錄只能是OpenHarmony SDK，配置方法可參考配置OpenHarmony SDK)，打開命令行工具，執(zhí)行如下命令(如果keytool命令不能執(zhí)行，請(qǐng)?jiān)谙到y(tǒng)環(huán)境變量中添加JDK的環(huán)境變量)。其中，只需要修改輸入和輸出即可快速生成證書文件，即修改**-infile指定證書請(qǐng)求文件csr文件路徑，-outfile**指定輸出證書文件名及路徑。

keytool -gencert -alias “OpenHarmony Application CA” -infile myApplication_ohos.csr -outfile myApplication_ohos.cer -keystore OpenHarmony.p12 -sigalg SHA384withECDSA -storepass 123456 -ext KeyUsage:“critical=digitalSignature” -validity 3650 -rfc

關(guān)于該命令的參數(shù)說(shuō)明如下：

• alias：用于簽發(fā)證書的CA私鑰別名，OpenHarmony社區(qū)CA私鑰存于OpenHarmony.p12密鑰庫(kù)文件中，該參數(shù)不能修改。
• infile：證書請(qǐng)求(CSR)文件的路徑。
• outfile：輸出證書鏈文件名及路徑。
• keystore：簽發(fā)證書的CA密鑰庫(kù)路徑，OpenHarmony密鑰庫(kù)文件名為OpenHarmony.p12，文件在OpenHarmony SDK中Sdk\toolchains\lib路徑下，該參數(shù)不能修改。請(qǐng)注意，該OpenHarmony.p12文件并不是生成密鑰和證書請(qǐng)求文件中生成的.p12文件。
• sigalg：證書簽名算法，該參數(shù)不能修改。
• storepass：密鑰庫(kù)密碼，密碼為123456，該參數(shù)不能修改。
• ext：證書擴(kuò)展項(xiàng)，該參數(shù)不能修改。
• validity：證書有效期，自定義天數(shù)。
• rfc：輸出文件格式指定，該參數(shù)不能修改。

3、生成應(yīng)用profile文件

Profile文件包含OpenHarmony應(yīng)用的包名、數(shù)字證書信息、描述應(yīng)用允許申請(qǐng)的證書權(quán)限列表，以及允許應(yīng)用調(diào)試的設(shè)備列表(如果應(yīng)用類型為Release類型，則設(shè)備列表為空)等內(nèi)容，每個(gè)應(yīng)用包中均必須包含一個(gè)Profile文件。

進(jìn)入Sdk\toolchains\lib目錄下，打開命令行工具，執(zhí)行如下命令。

java -jar provisionsigtool.jar sign --in UnsgnedReleasedProfileTemplate.json 
--out myApplication_ohos_Provision.p7b --keystore OpenHarmony.p12 --storepass 
123456 --alias “OpenHarmony Application Profile Release” --sigAlg 
SHA256withECDSA --cert OpenHarmonyProfileRelease.pem --validity 365 
--developer-id ohosdeveloper --bundle-name 包名 --permission 受限權(quán)限名(可選) 
--permission 受限權(quán)限名(可選) --distribution-certificate myApplication_ohos.cer

關(guān)于該命令的參數(shù)說(shuō)明如下：

• oprovisionsigtool：Profile文件生成工具，文件在OpenHarmony SDK的Sdk\toolchains\lib路徑下。
• in：Profile模板文件所在路徑，文件在OpenHarmony SDK中Sdk\toolchains\lib路徑下，該參數(shù)不能修改。
• out：輸出的Profile文件名和路徑。
• keystore：簽發(fā)證書的密鑰庫(kù)路徑，OpenHarmony密鑰庫(kù)文件名為OpenHarmony.p12，文件在OpenHarmony SDK中Sdk\toolchains\lib路徑下，該參數(shù)不能修改。
• storepass：密鑰庫(kù)密碼，密碼為123456，該參數(shù)不能修改。
• alias：用于簽名Profile私鑰別名，OpenHarmony社區(qū)CA私鑰存于OpenHarmony.p12密鑰庫(kù)文件中，該參數(shù)不能修改。
• sigalg：證書簽名算法，該參數(shù)不能修改。
• cert：簽名Profile的證書文件路徑，文件在OpenHarmony SDK中Sdk\toolchains\lib路徑下，該參數(shù)不能修改。
• validity：證書有效期，自定義天數(shù)。
• developer-id：開發(fā)者標(biāo)識(shí)符，自定義一個(gè)字符串。
• bundle-name：填寫應(yīng)用包名。
• permission：可選字段，如果不需要，則可以不用填寫此字段;如果需要添加多個(gè)受限權(quán)限，則如示例所示重復(fù)輸入。受限權(quán)限列表如下：ohos.permission.READ_CONTACTS、ohos.permission.WRITE_CONTACTS。
• distribution-certificate：生成應(yīng)用證書文件中生成的證書文件。

4、配置應(yīng)用簽名信息

在真機(jī)設(shè)備上調(diào)試前，需要使用到制作的私鑰(.p12)文件、證書(.cer)文件和Profile(.p7b)文件對(duì)調(diào)試的模塊進(jìn)行簽名。

打開File > Project Structure，點(diǎn)擊Project > Signing Configs > debug窗口中，去除勾選“Automatically generate signing”，然后配置指定模塊的調(diào)試簽名信息。

• Store File：選擇密鑰庫(kù)文件，文件后綴為.p12，該文件為生成密鑰和證書請(qǐng)求文件中生成的.p12文件。
• Store Password：輸入密鑰庫(kù)密碼，該密碼為生成密鑰和證書請(qǐng)求文件中填寫的密鑰庫(kù)密碼保持一致。
• Key Alias：輸入密鑰的別名信息，與生成密鑰和證書請(qǐng)求文件中填寫的別名保持一致。
• Key Password：輸入密鑰的密碼，與Store Password保持一致。
• Sign Alg：簽名算法，固定為SHA256withECDSA。
• Profile File：選擇生成應(yīng)用Profile文件中生成的Profile文件，文件后綴為.p7b。
• Certpath File：選擇生成應(yīng)用證書文件中生成的數(shù)字證書文件，文件后綴為.cer。

設(shè)置完簽名信息后，點(diǎn)擊OK進(jìn)行保存，然后可以在工程下的build.gradle中查看簽名的配置信息。

默認(rèn)情況下，DevEco Studio編譯hap包的類型為debug類型，如果需要編譯release類型的hap包，請(qǐng)打開工程左下角的OhosBuild Variants，設(shè)置模塊的編譯構(gòu)建類型為release。關(guān)于編譯構(gòu)建hap的詳細(xì)說(shuō)明請(qǐng)參考HUAWEI DevEco Studio使用指南。

編譯完成后，OpenHarmony應(yīng)用的Hap包可以從工程的bulid目錄下獲取。

第5步：安裝及運(yùn)行應(yīng)用。

使用hdc工具將編譯后的本地hap包安裝到單板上。

安裝命令 install [-r/-d/-g] package

命令示例：

hdc install E:\ entry-debug-rich-signed.hap

說(shuō)明：藍(lán)色表示要安裝的hap包在本地的路徑。

?卸載命令 uninstall [-k] package

命令示例：

hdc uninstall com.example.relayapplication.hmservice

說(shuō)明：藍(lán)色表示hap包的bundleName。

擊觸屏上的Hap圖標(biāo)或者使用命令啟動(dòng)Hap包。

aa start -d l -a mainAbility -b bundleName,其中mainAbility, bundleName換成自己開發(fā)的應(yīng)用名字(可在應(yīng)用工程的config.json文件中查到)。如下打印表示應(yīng)用啟動(dòng)成功：

??想了解更多內(nèi)容，請(qǐng)?jiān)L問(wèn)：??

??51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)??

??https://ost.51cto.com??