iOS篇
分發(fā)前需要有已打包ipa文件庭瑰,打包詳見《Xamarin 開發(fā)文檔》
在蒲公英平臺:https://www.pgyer.com創(chuàng)建賬號并認證為開發(fā)者
上傳版本,即ipa文件峻汉,成功后填寫應用信息饭宾,并設置安裝方式
-
應用在蒲公英上的一些接口參數(shù)說明
API Key:當前賬號接入唯一標識节预,也是訪問蒲公英開放接口的關鍵參數(shù)惭适,在接口中為:_api_key科阎;該參數(shù)可在上傳app中的API查看辆苔,也可以在我的賬號中查看到算灸;是蒲公英用來識別API調(diào)用者的身份,該參數(shù)可在賬號管理內(nèi)重置驻啤;
APP ID
:表示一個App組的唯一ID菲驴,可在應用管理中查看;組的含義為同一個app會有多個版本骑冗,那這些版本為一個App組赊瞬,該參數(shù)表示這個組的ID;在接口中表示為aId沐旨,獲取版本信息接口的關鍵參數(shù)森逮;User Key
:用戶Key,用來標識當前用戶的身份磁携;對于同一個蒲公英的注冊用戶來說褒侧,這個值在固定的;在某些接口會使用到谊迄;aKey
:代表一個具體的App的唯一標識闷供。不同的版本具有不同的aKey,這個值一般是通過其他接口返回的统诺,不能在開發(fā)接口中測試得到歪脏;是安裝app的必要參數(shù),檢測版本更新獲取最新aKey即能安裝最新版本粮呢;
-
蒲公英接口使用說明
安裝說明:Xamarin開發(fā)婿失,因此未選擇iOS端特有方法安裝钞艇,通過Xamarin中Device類訪問安裝URL跳轉(zhuǎn)Safari中實現(xiàn)更新安裝;接口會根據(jù)應用的類型(iOS或Android)豪硅,自動使用相應的的安裝方式來安裝應用哩照;
安裝接口:
http://www.pgyer.com/apiv1/app/install?_api_key=&aKey= &password=,懒浮;接口為GET請求飘弧,需要參數(shù)為_app_id,aKey, pwd,當應用需要安裝密碼時砚著,請傳入應用安裝密碼次伶;通過Xamarin中Device訪問該路徑;獲取app組接口:同一個 App 的不同版本稽穆,蒲公英會將它們合并起來冠王,形成一個App 的集合,這個集合我們稱之為一個"App組"秧骑。對于一個"App組"版确,會有一個唯一的 App Id 與之對應。該接口用來獲取 App 組的詳細信息乎折;
4.app組接口返回值:會返回app ID下的所有版本信息,每個版本的Akey和appQRCodeURL(二維碼)侵歇,需要說明的是同一個組下半天版本的app的aKey和二維碼鏈接是不相同的骂澄,返回值還會攜帶版本是否為最新,參數(shù)為appIsFirst惕虑,返回“1”為最新版本坟冲,返回“2”為否;因此需要在打包前內(nèi)置一個本地版本溃蔫,遍歷所有版本匹配蒲公英appVersion版本和內(nèi)置版本是否相同健提,即可知道安裝版本是否為最新,版本組為金額類型伟叛,因此最新版本為lastObject私痹,獲取最新版本的akey用于更新,appQRCodeURL用于提供二維碼安裝接口统刮;
app組接口格式:http://www.pgyer.com/apiv1/app/viewGroup 紊遵,為POST方式請求,通過HttpClietn類庫訪問侥蒙,傳入?yún)?shù)為_api_key暗膜,aId(aId即App ID)
Notice: 因為通過Xamarin開發(fā),集成SDK過于繁瑣鞭衩,且僅為版本更新實在沒有必要学搜,因此考慮使用接口方式實現(xiàn)版本更新娃善;通過Froms平臺和API方式以及Xamarin的Forms類庫中Device方式安裝更新,應該是可以兼容Android方式版本更新(未測試)
更新提示:每次程序啟動延遲1s后瑞佩,獲取app組信息会放,反序列化后,遍歷得到的版本集合和本地內(nèi)置版本比較钉凌,即可知道當前版本是否為最新咧最;之后將最新版本的安裝aKey提取出來,異步響應更新彈出框御雕,讓用戶選擇更新或者是取消矢沿;若數(shù)據(jù)請求失敗或沒有連接網(wǎng)絡,在點擊設置頁面時會再次請求酸纲,若有更新則彈出更新提示框捣鲸,無則不提示;存在新版本會將最新版本以紅色字體在設置頁面呈現(xiàn)闽坡;處理點檢查版本:為了實時響應版本更新栽惶,即不退出程序出現(xiàn)新更新也實時檢測,點擊版本更新按鈕會重新請求數(shù)據(jù)疾嗅,做更新檢查外厂,為最新版本也會彈出提示框,若有更新則彈出更新提示框代承,異步響應點擊結(jié)果汁蝶。更新僅會提示一次。
Android版本
在蒲公英平臺上论悴,將Android和iOS端合并掖棉,兩個平臺的區(qū)別僅為App ID不同,因此可以共用相同的接口和邏輯處理膀估,也是通過瀏覽器進行安裝
文檔為記錄自己使用總結(jié)幔亥,有不當之處輕輕噴 -_-||