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;
}

最後にランタイムエンジンのバージョンと比較を行ない、バージョンが低い場合にはアラートを出します。

会員登録(無料)はこちらから