var cordova= device.cordova;
var platform = device.platform;
var uuid = device.uuid;
var version = device.version;
var isDevicesRooted;
^변수^설명^비고^
|cordova|어플리케이션에서 사용된 폰갭 버전을 반환한다.| |
|platform|모바일 디바이스의 플랫폼 정보를 반환한다.| |
|uuid|디바이스 고유의 UUID를 반환한다.| |
|version|디바이스의 플랫폼 버전을 반환한다.| |
|isDevicesRooted|디바이스에 루팅 및 탈옥 결과정보를 반환한다.| |
== Event[batterycritical] ==
* 배터리 상태가 Critical 레벨에 도달 했을때 호출되는 콜백함수 정의
window.addEventListener("batterycritical", yourCallbackFunction, false);
== Event[batterylow] ==
* 배터리 상태가 Low 레벨에 도달 했을때 호출되는 콜백함수 정의
window.addEventListener("batterylow", yourCallbackFunction, false);
== Event[batterystatus] ==
* 배터리 상태에 변화가 감지되면 호출되는 콜백함수 정의
window.addEventListener("batterystatus", yourCallbackFunction, false);
==== Server Application ====
=== 관련 소스 ===
^유형^대상소스명^비고^
|Controller|egovframework.hyb.mbl.jai.web.EgovJailbreakDetectionDeviceAPIController.java|JailbreakDetectionAPI 가이드 프로그램 Controller Class|
|Service|egovframework.hyb.add.dvc.service.EgovJailbreakDetectionDeviceAPIService.java|JailbreakDetectionAPI 가이드 프로그램 Service Class|
|ServiceImpl|egovframework.hyb.add.dvc.service.impl.EgovJailbreakDetectionDeviceAPIServiceImpl.java|JailbreakDetectionAPI 가이드 프로그램 ServiceImpl Class|
|VO|egovframework.hyb.add.dvc.service.JailbreakDetectionDeviceAPIVO.java|JailbreakDetectionAPI 가이드 프로그램 VO Class|
|DAO|egovframework.hyb.add.dvc.service.impl.JailbreakDetectionDeviceAPIDAO.java|JailbreakDetectionAPI 가이드 프로그램 Dao Class|
|QUERY XML|resources/egovframework/sqlmap/hyb/add/dvc/EgovJailbreakDetectionDeviceAPIGuide_SQL_xxx.xml|JailbreakDetectionAPI 가이드 프로그램 QUERY XML|
=== 관련 테이블 ===
^테이블명^테이블명(영문)^비고^
|탈옥정보|detection|탈옥 및 루팅 정보 관리|
=== 테이블 정의서 ===
* Device
^No^컬럼ID^컬럼명^타입^길이^NULL^
|1|SN|일련번호|NUMERIC|6|NotNull|
|2|UUID|UUID|VARCHAR|45|NotNull|
|3|OS|OS|VARCHAR|45|NotNull|
|4|PG_VER|폰갭버전|VARCHAR|45|NotNull|
|5|DETECTION|탈옥여부|VARCHAR|45|NotNull|
=== ERD ===
{{:egovframework:hyb3.6:guide:mbl:newapi_erd.jpg?700|}}
===== 환경설정 =====
JailbreakDetection 디바이스API 가이드 프로그램에서 제공하는 모바일 디바이스의 메타 정보 조회 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.
==== Device Application ====
=== res/xml/config.xml ===
== ExternalHosts ==
== [Project_Name]/eGovModule/EGovComModule.h ==
#define kSERVER_URL @"Server_URL"
==== Server Application ====
=== resource/egovframework/sqlmap/sql-map-config_[DB명].xml ===
===== 관련기능 =====
JailbreakDetectionAPI 가이드 프로그램은 크게 디바이스 내 메타 정보 조회 기능과 조회된 메타 정보를 서버에 전송하고 조회할수 있는 기능으로 구성되어 있다.
==== JailbreakDetectionAPI 정보 조회하기 ====
=== 비즈니스 규칙 ===
* 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
=== 관련 코드 ===
== 디바이스 정보 VO ==
/** 디바이스 정보 VO */
var deviceInfoVO = {
sn : "",
uuid : "",
os : "",
pgVer : "",
detection : ""
}
== 디바이스 정보 및 탈옥/루팅 화면 표시 ==
function fn_egov_detectio(){
var successCallback = function (result) {
var isDevicesRooted = result == 1;
$('.deviceInfo:eq(0)').html(device.platform + " " + device.version);
$('.deviceInfo:eq(1)').html(device.uuid);
$('.deviceInfo:eq(2)').html(device.cordova);
$('.deviceInfo:eq(3)').html(" " + isDevicesRooted);
};
var errorCallback = function (error) {
console.error(error);
};
rootdetection.isDeviceRooted(successCallback, errorCallback);
$.mobile.changePage('#deviceInfo', 'slide', false, false);
infoScroll.refresh();
}
== 네트워크 정보 조회 ==
function fn_egov_get_networkInfo() {
var networkState = navigator.network.connection.type;
var states = {};
states[Connection.UNKNOWN] = 'Unknown connection';
states[Connection.ETHERNET] = 'Ethernet connection';
states[Connection.WIFI] = 'WiFi connection';
states[Connection.CELL_2G] = 'Cell 2G connection';
states[Connection.CELL_3G] = 'Cell 3G connection';
states[Connection.CELL_4G] = 'Cell 4G connection';
states[Connection.NONE] = 'No network connection';
return states[networkState];
}
=== 관련 화면 및 수행매뉴얼 ===
^디바이스 정보조회 화면^
|{{:egovframework:hyb3.6:guide:mbl:jailbreakdetection:jailbreakdetectionios_2.png?320|}}|
OS: 플랫폼 정보 및 버전 \\
UUID : 디바이스의 고유 아이디 \\
PhoneGap Version : jailbreakdetection가이드 프로그램에 적용된 폰갭 버전 \\
Jailbreak Detection : 디바이스의 탈옥 및 루팅 여부 \\
==== jailbreakdetection 정보 서버에 전송하기 ====
=== 비즈니스 규칙 ===
* 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
* 디바이스 정보의 서버 전송은 InterfaceAPI를 이용한다.
=== 관련 코드 ===
== jailbreakdetection 정보 등록==
function fn_egov_save_detectioInfo(){
var url = "/jai/addJailbreakDetectionDeviceInfo.do";
var d_os = $(".deviceInfo:eq(0)").text();
var d_uuid = $(".deviceInfo:eq(1)").text();
var d_pg_ver = $(".deviceInfo:eq(2)").text();
var d_detection = $(".deviceInfo:eq(3)").text();
console.log("os > " + d_os + "\n uuid >>> " + d_uuid + "\n pg_ver : >>>>" + d_pg_ver + "<<<<<< \n detection >>" + d_detection + "<<<<");
var params = {
os : d_os,
uuid : d_uuid,
pgVer : d_pg_ver,
detection : d_detection
};
window.plugins.EgovInterface.request(url, params, function(jsondata) {
console.log("jsondata > " + jsondata);
if (jsondata.resultState == "OK") {
console.log("send ok");
} else {
$("#alert_dialog").click(function() {
jAlert('데이터 전송 중 오류가 발생 했습니다.', '전송 오류', 'c');
});
}
}, function(result) {
console.log("error > " + result);
});
console.log("JailbreakDetectionDeviceInfo fn_egov_save_detectioInfo request Completed");
$.mobile.changePage("#main", "slide", false, false);
detailScroll.refresh();
}
=== 관련 화면 및 수행매뉴얼 ===
^Action^URL^Controller method^QueryID^
|JailbreakDetection정보 등록|/jai/addJailbreakDetectionDeviceInfo.do|insertDeviceInfo|"jailbreakDetectionDeviceAPIDAO.insertJailbreakDetectionDevcie"|
정보 업로드: JailbreakDetection 결과 정보를 서버로 업로드 한다.
==== JailbreakDetection 정보 목록 조회하기 ====
=== 비즈니스 규칙 ===
* 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
=== 관련 코드 ===
== 디바이스 정보 목록 조회 ==
function fn_egov_move_JailbreakDetectionInfoList() {
var url = "/jai/JailbreakDetectionInfoList.do";
var accept_type = "json";
var params = {
uuid : device.uuid,
};
// get the data from server
window.plugins.EgovInterface.request(url, params, function(jsonData) {
var list_html = "";
$(jsonData["JailbreakDetectionDevcieList"]).each(function(idx,obj){
var sn = obj.sn;
var uuid = obj.uuid;
var os = obj.os;
var pgVer = obj.pgVer;
var detection = obj.detection;
console.log("uuid >>>> " + uuid + "\n os >>>>>>> " + os + "\n pgVer >>> " + pgVer + "<<<<<<" + "\n detection >>> " + detection + "<<<<<<");
list_html += "UUID : " + uuid + "
";
list_html += "OS : " + os + "
";
list_html += "Version : " + pgVer + "
";
list_html += "Detection : " + detection + "
=== 관련 화면 및 수행매뉴얼 ===
^Action^URL^Controller method^QueryID^
|JailbreakDetection 정보 목록 조회|/jai/JailbreakDetectionInfoList.do|selectJailbreakDetectionDevcieList|"jailbreakDetectionDeviceAPIDAO.selectJailbreakDetectionDevcieList"|
^디바이스 정보목록 조회 화면^
|{{:egovframework:hyb3.6:guide:mbl:jailbreakdetection:jailbreakdetectionios_3.png?320|}}|
메인화면 이동 : 메인 페이지를 호출한다.\\
===== 컴파일 디버깅 배포 =====
==== 컴파일 ====
=== Device Applicaton 컴파일 방법 ===
* 왼쪽 상단의 삼각형 버튼을 클릭하면 가이드 프로그램이 빌드되어 아이폰 디바이스에 설치 된다.
{{:egovframework:hyb3.6:guide:mbl:ios_app_compile.png?740|}}
* 빌드가 성공하면 아래와 같은 어플리케이션 실행화면을 확인 할 수 있다.
{{:egovframework:hyb3.6:guide:mbl:jailbreakdetection:jailbreak_run_ios.png?320|}}
=== Server Applicaton 컴파일 방법 ===
* 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.
{{:egovframework:hyb:guide:ios:서버실행.png?640|}}
* 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.
{{:egovframework:hyb:guide:add:서버실행결과_콘솔.png?840|}}
==== 디버깅 ====
디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 console.log를 이용할 수 있다. console.log 함수는 자바스크립트 구문에서 사용할 수 있는 디버그 코드로 이클립스 및 Xcode에서 확인 할 수 있다.
* 실제 콘솔 로그 예
function fn_egov_network_check(doCheck)
{
console.log('DeviceAPIGuide fn_egov_network_check');
var networkState = navigator.network.connection.type;
...
}
* xCode 콘솔 창
{{:egovframework:hyb:guide:ios:cameradebugxcode.png?700|}}\\
==== 배포 ====
JailbreakDetection 디바이스 API 가이드 다운로드 : [[http://www.egovframe.go.kr/cop/bbs/selectBoardArticle.do?bbsId=BBSMSTR_000000000161&nttId=1290&menu=3&submenu=9|Click]] \\
===== 참고자료 =====
* Cordova 플러그인 정보(iOS) : cordova plugin add cordova-plugin-jailbreak-detection[[https://www.npmjs.com/package/cordova-plugin-jailbreak-detection|Click]] \\
* Cordova 플러그인 정보(Android) : cordova plugin add cordova-plugin-root-detection[[https://www.npmjs.com/package/cordova-plugin-root-detection|Click]] \\