一、創(chuàng)建項(xiàng)目

• 打開 Hbuilder 創(chuàng)建一個(gè)新項(xiàng)目

• 登錄 DCloud 開發(fā)者中心，新建一個(gè)應(yīng)用（注意： 上面第一步在 Hbuilder 創(chuàng)建新項(xiàng)目時(shí)，如果已經(jīng)登錄了 HBuilder 賬號(hào)，那么下面這一步可以省略，HBuilder 會(huì)自動(dòng)幫你創(chuàng)建好這個(gè)應(yīng)用）

• 創(chuàng)建好應(yīng)用應(yīng)該之后，復(fù)制 Appid，打開 manifest.json，將 uni-app 應(yīng)用標(biāo)識(shí)(Appid) 替換成我們新創(chuàng)建應(yīng)用的 Appid

二、生成簽名證書

uni-app 安卓證書生成有兩種方式，一種是去 DCloud 開發(fā)者中心生成證書（下面我們就采用這種方式），另一種是安裝 jre 環(huán)境，生成證書（參考鏈接 ： https://ask.dcloud.net.cn/article/35777）

• 點(diǎn)擊應(yīng)用名稱，
  
• 切換至【Android云端證書】，創(chuàng)建證書（生成證書一般需要 1-5 分鐘時(shí)間）

• 證書生成之后，點(diǎn)擊證書詳情，復(fù)制 MD5、SHA1、SHA256 備用

• 切換至【各平臺(tái)信息】，點(diǎn)擊新增

• 將之前復(fù)制 MD5、SHA1、SHA256 填寫進(jìn)去，包名可以自己定義（eg: com.app.uniPush）

三、開通 unipush 推送服務(wù)

• 在【unipush】-【1.0(老版本)】-【應(yīng)用信息】，選中我們上面創(chuàng)建的應(yīng)用，我們這里只測(cè)試 Android 平臺(tái)，所以勾選去掉 IOS，最后點(diǎn)擊開通應(yīng)用；
  

四、客戶端集成

• 打開項(xiàng)目， 點(diǎn)擊 manifest.json，選擇【App模塊配置】，否選【Push(消息推送)】，uniPush 消息推送圖標(biāo)，大家可自行配置；

• 獲取 cid（ClientId：個(gè)推業(yè)務(wù)層中的對(duì)外用戶標(biāo)識(shí)，用于標(biāo)識(shí)客戶端身份，由第三方客戶端獲取并保存到第三方服務(wù)端，是個(gè)推 SDK 的唯一識(shí)別號(hào)，簡(jiǎn)稱 CID）

• 在應(yīng)用安裝后第一次運(yùn)行時(shí)應(yīng)該調(diào)用 5+ API 的 plus.push.getClientInfoAsync 方法獲取客戶端標(biāo)識(shí)。

• 如果獲取的 cid 為空，說明客戶端向推送服務(wù)器注冊(cè)還未完成，可以使用 setTimeout 延時(shí)重試

plus.push.getClientInfoAsync((info) => {let cid = info["clientid"];
});

四、制作自定義調(diào)試基座

• 打開項(xiàng)目， 點(diǎn)擊 manifest.json，選擇【App模塊配置】，否選【Push(消息推送)】，uniPush 消息推送圖標(biāo)，大家可自行配置；

• 【運(yùn)行】-【運(yùn)行到手機(jī)或模擬器】-【制作自定義調(diào)試基座】

• 打包需要的信息，都可通過 Dcloud 獲取，可參考下的圖
  
• 【運(yùn)行】-【運(yùn)行到手機(jī)或模擬器】-【運(yùn)行到Android App 基座】
  

五、開發(fā)者中心后臺(tái)Web頁面推送（僅支持在線推送）

• 登錄 DCloud 開發(fā)者中心，左側(cè)選擇【Uni Push】，打開消息推送頁面，這里我們直接用 cid 向設(shè)備發(fā)送消息
• 需要打開真機(jī)，獲取到真機(jī)上面的 cid（clientid）
• 當(dāng)前消息推送僅支持在線推送，當(dāng) CID 在線（即 app 在前臺(tái)打開運(yùn)行）

• 點(diǎn)擊預(yù)覽，輸入cid，點(diǎn)擊測(cè)試即可
• 注意：如果提示 cid 不存在或應(yīng)用錯(cuò)誤，CID不存在或不屬于此應(yīng)用，請(qǐng)仔細(xì)檢查一下 Appid 是否正確，是否有自定義基座，如果之前有安裝過相同的應(yīng)用可以先卸載之前的，重新安裝；

六、離線消息推送

• 若需要支持主流 android 廠商客戶端接收離線推送，需要完成 ：android 多廠商配置，下面以華為應(yīng)用為例
• 配置好廠商參數(shù)后請(qǐng)一定要提交云打包，并且使用“自有證書”打簽名包；將云打包后的安裝包安裝到手機(jī)上，再獲取cid 進(jìn)行離線廠商推送測(cè)試，不可使用基座方式獲取的 cid 進(jìn)行離線廠商推送測(cè)試

1、創(chuàng)建華為開發(fā)者賬號(hào)

• 打開 開發(fā)華為開發(fā)者聯(lián)盟，注冊(cè)華為開發(fā)者帳號(hào)，帳號(hào)注冊(cè)完后，需要完成實(shí)名認(rèn)證才能享受華為開放的各類能力和服務(wù)

2、開通推送服務(wù)

• 確認(rèn)開通后，還需要在【配置】開通精準(zhǔn)推送服務(wù)

3、創(chuàng)建項(xiàng)目

• 是否開開通分享服務(wù)，可根據(jù)需求自行選擇

4、添加應(yīng)用

• 在左側(cè)導(dǎo)航欄選擇【項(xiàng)目設(shè)置】，點(diǎn)擊添加應(yīng)用，將應(yīng)用添加到我們新創(chuàng)建的項(xiàng)目中

5、添加SHA256證書指紋

• 打開 Dcloud，點(diǎn)擊證書詳情，從里面找到 SHA256 復(fù)制粘貼到下圖處即可

6、開通推送服務(wù)

• 切換到【API管理】，開通推送服務(wù)

7、Dcloud 平臺(tái)廠商推送配置

• 下載 agconnect-services.json 文件，將該文件中 json 數(shù)據(jù)粘貼到 Dcloud 廠商配置中，見下圖。

8、安裝 app 到真機(jī)

• 【發(fā)行】-【原生App-云打包】詳細(xì)流程參請(qǐng)考上面的【制作自定義調(diào)試基座】

9、華為離線消息測(cè)試

-【 Android 配置】 - 【通知類型】 - initende 內(nèi)容

intent:#Intent;action=android.intent.action.oppopush;launchFlags=0x14000000;component=安卓包名/io.dcloud.PandoraEntry;S.UP-OL-SU=true;S.title=測(cè)試標(biāo)題;S.content=測(cè)試內(nèi)容;S.payload=test;end

• 華為離線時(shí)，收不到消息推送，若廠商信息確認(rèn)配置無誤，那么注意以下兩個(gè)地方

1. 核對(duì) Android 應(yīng)用簽名SHA256 是否填寫正確

2. 華為推送信息亂寫的時(shí)候，是可能不被推送的，可以按照以下格式發(fā)送排查下：

   title：訂單提醒
   body：您的外賣訂單已接單，請(qǐng)耐心等候

10、獲取 Device Token 發(fā)送消息

• 華為端發(fā)送消息都是通過 token 進(jìn)行推送，獲取接收離線消息的設(shè)備 token
• 打開 Dcloud，【unipush】-【消息推送】-【配置管理】-【故障排查】- 【狀態(tài)查詢】- 輸入設(shè)備的 cid 即可查詢到對(duì)應(yīng)的 Device Token