Tutorialチュートリアル
特定のランタイムエンジンを利用させたい場合には
端末にインストールされているアプリが、開発者の想定するランタイムエンジンのバージョンより低いバージョンでビルドされている場合に、アラートを出すサンプルになります。
Google PlayやApp Storeにアプリのアップデートを促したい場合に有効です。
Javascript
(function() {
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady(){
var contentsVersion = "1.2.3";
var contents = versionFormat(contentsVersion);
var runtime = versionFormat(applican.device.applican);
if(contents < runtime) {
alert("ランタイムエンジンが古いため、アプリが正常に動作しない可能性があります。アプリのアップデートを行ってください。");
return;
}
}
function versionFormat(version) {
var v = version.replace( /(^|\.)(\d+)/g , function(m, dot, n){
return dot ? ("000" + n).slice(-3) : (n + ".");
});
return parseFloat(v);
}
解説
applican.device.applican
このAPIを呼ぶことにより、ランタイムエンジンのバージョンが取得できます。関連API: Device
var contentsVersion = "1.2.3";
想定するバージョンを指定します。サンプルでは仮に1.2.3を指定しています。
versionFormat(contentsVersion); // サンプルの場合 1.002003 を返します。
versionFormat関数を呼び出すことにより想定するバージョンを比較しやすい形に変換します。
if(contents < runtime) {
alert("ランタイムエンジンが古いため、アプリが正常に動作しない可能性があります。アプリのアップデートを行ってください。");
return;
}
最後にランタイムエンジンのバージョンと比較を行ない、バージョンが低い場合にはアラートを出します。