웹소스 버전관리 및 배포 (WebResourceUpdate) 디바이스API 가이드 프로그램

웹소스 버전관리 및 배포(WebResourceUpdate) 가이드 프로그램은 디바이스 API 실행환경을 활용하여 하이브리드 앱을 개발 시 참고 및 활용될 수 있도록 구현된 전자정부 디바이스 API에 대한 가이드 앱으로써, 모바일 디바이스의 WebResourceUpdate관련 기능을 JavaScript기반으로 구성 된 WebResourceUpdate DeviceAPI를 통하여 웹 리소스의 최신버전 조회 및 버전 업데이트를 진행할 수 있는 기능을 지원한다.

본 가이드 프로그램에서는 웹 서버에서 웹소스 최신버전 조회 및 현재 버전 비교 기능과 업데이트를 통하여 최신버전 반영(다운로드 포함)을 할 수 있는 기능을 제공하고 있다.

웹소스 버전관리 및 배포(WebResourceUpdate) 디바이스API 가이드 프로그램는 최신버전 정보 조회, 버전 배포, 그리고 업데이트 확인 기능으로 구성되어 있다.(관련기능 부분참조)

• 현재 웹소스의 버전 정보를 확인한다.

window.plugins.EgovResourceUpdate.getResourceVersion(onResult());

• 웹 서버에 최신 버전 정보를 조회하여 로드한다.

window.plugins.EgovInterface.request(url, params, onSuccess);

• 웹소스 최신버전을 다운로드 받아 적용한다.

window.plugins.EgovResourceUpdate.update(url, params, onSuccess(), onError());

• RESOURCE_UPDATE

• FILE_DETAIL_INFO

웹소스 버전관리 및 배포(WebResourceUpdate) 디바이스API 가이드 프로그램에서 제공하는 웹소스 버전 조회, 웹소스 버전 다운로드 및 배포, 웹소스 확인 등의 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.

    <!--전자정부 문서뷰어 API를 사용하기 위한 Custom Plugin 클래스-->
    <feature name="EgovResourceUpdate">
        <param name="android-package" value="kr.go.egovframework.hyb.plugin.EgovResourceUpdate" />
    </feature>

    <!--전자정부 Interface 디바이스 API에서 사용하기 위한 서버경로 설정-->
    <?xml version="1.0" encoding="utf-8"?>
    <resources>
	<string name="SERVER_URL">http://192.168.100.222:8080/DeviceAPIGuideTotal_Web</string>
    </resources>

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
    <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
    <permission android:name="kr.go.egovframework.hyb.example.permission.C2D_MESSAGE" android:protectionLevel="signature" />
    <uses-permission android:name="kr.go.egovframework.hyb.example.permission.C2D_MESSAGE" />

<sqlMap resource="egovframework/sqlmap/hyb/mbl/upd/EgovResourceUpdateDeviceAPIGuide_SQL_[DB명].xml"/>

웹소스 버전관리 및 배포(WebResourceUpdate) API 가이드 프로그램은 웹서버에서 최신 웹소스 버전을 조회하여 해당 버전에 대한 파일 다운로드 및 배포를 할 수 있는 기능으로 구성되어 있다. 또한, 배포 후 웹소스의 확인을 위한 페이지 기능도 구성되어 있다.

• 현재 웹소스 버전을 조회한다.
• 웹서버에서 최신 웹소스 버전을 조회한다.

window.plugins.EgovResourceUpdate.getResourceVersion(function(jsondata) {
        jsonresult = jsondata;
        console.log("jsondata.resVersion > "+jsondata.resVersion);
        console.log("jsondata.resDistDt > "+jsondata.resDistDt);
        console.log("jsondata.resInstallDt > "+jsondata.resInstallDt);
        resVersion = jsondata.resVersion;
        resDistDt = jsondata.resDistDt;
        resInstallDt = jsondata.resInstallDt;       
        
	});

function fn_egov_update_lastestVersion() {
    
    //alert("REQ UPDATE INFO");
    console.log(">>>appId : "+appId);
    console.log(">>>device.platform : "+device.platform);
    
    var url = "/upd/ResourceUpdateVersionInfo.do";
    
    var params = {
        appId : appId ,
        osType : device.platform};
    
    window.plugins.EgovInterface.request(url, params, function(jsondata) {
                                         //var data = JSON.parse(jsondata);
                                         //alert("jsondata : "+jsondata);
                                         console.log("jsondata > "+jsondata);
                                         resultJson = jsondata;                                         
                                         resLastestVersion = jsondata.result.resVersion;
                                         orignlFileNm = jsondata.result.orignlFileNm;
                                         streFileNm = jsondata.result.streFileNm;
                                         resVersionUpdDt = jsondata.result.updDt;
                                         resUpdateContent = jsondata.result.updateContent;
                                         console.log("server resLastestVersion : "+jsondata.result.resVersion);
                                         console.log("server orignlFileNm : "+jsondata.result.orignlFileNm);
                                         console.log("server streFileNm : "+jsondata.result.streFileNm);
                                         console.log("server resVersionUpdDt : "+jsondata.result.updDt);
                                         console.log("server resUpdateContent : "+jsondata.result.updateContent);

                                         if(jsondata.resultState == "OK"){
                                        	 	$('.deviceInfo:eq(0)').html(resVersion);
                                        		$('.deviceInfo:eq(1)').html(resDistDt);
                                        		$('.deviceInfo:eq(2)').html(resInstallDt);    
                                        		$('.deviceInfo:eq(3)').html(resLastestVersion);
                                        		$('.deviceInfo:eq(4)').html(resVersionUpdDt);
                                        	 
                                        		console.log("페이지 전환 ");
                                        	    $.mobile.changePage('#deviceInfo', 'slide', false, false);
                                        	    infoScroll.refresh();;
                                        	    
                                        	    console.log("send push ok");
                                         }else{
                                         $("#alert_dialog").click( function() {
                                             jAlert('데이터 전송 중 오류가 발생 했습니다.', '전송 오류', 'c');
                                           });
                                         }
                                         
                                         }, function(result){
                                        	 alert("error > "+result);
                                         });
    
}

• 최신 버전이 존재하면 웹소스를 다운받아 디바이스에 적용한다.

function fn_egov_update_go() {

	jConfirm('최신버전을 적용하시겠습니까?', '알림', 'c', function(r) {
        if (r == true) {
        	fn_egov_update_action();
        }
    });
	
}

function fn_egov_update_action() {
	
    var url = "/upd/ResourceUpdatefileDownload.do";
    
    /*console.log("member resLastestVersion : "+resLastestVersion);
    console.log("member orignlFileNm : "+orignlFileNm);
    console.log("member streFileNm : "+streFileNm);
    console.log("member resLastestVersion : "+resLastestVersion);
    console.log("member resVersionUpdDt : "+resVersionUpdDt);
    */
        
    var params = {
        orignlFileNm :  orignlFileNm ,
        streFileNm : streFileNm,
        resLastestVersion : resLastestVersion,
        targetPath : null,
        resVersionUpdDt : resVersionUpdDt};
    
    window.plugins.EgovResourceUpdate.update(url, params, function(jsondata) {
        jsonresult = jsondata;
        console.log("jsondata > "+jsondata);
        
        resVersion = jsondata.resVersion;        
        resDistDt = jsondata.resDistDt;
        resInstallDt = jsondata.resInstallDt;
                    	 	    	 	
    	$.mobile.changePage('#main', 'slide', false, false);
    	infoScroll.refresh();    	    
	      
        }, function(result){
           alert("error > "+result);
        });

}

최신버전 적용 확인 화면	웹소스 다운로드 화면

• 최신버전이 적용 된 화면을 표시한다.

function fn_egov_update_goNewPage() {
    //alert(cordova.file.dataDirectory);
    console.log(">>> Web Resource Directory: "+cordova.file.dataDirectory);
    //location.href=cordova.file.dataDirectory+"/www/update.html";
    
    $("#ifUpdatepages").attr("src", cordova.file.dataDirectory+"/www/update.html");
    $.mobile.changePage('#updateInfo', 'slide', false, false);
	infoScroll.refresh(); 
}

메뉴 화면	웹소스 확인 화면

• 프로젝트 선택 > 오른쪽 클릭 > Run As > Android Application

• 상단의 메뉴 > Run As > Android Application

• 실행할 타겟 선택 > 에뮬레이터, 디바이스(디버깅모드)

• 디바이스를 이용한 실행 화면

• 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.

• 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.

디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 console.log를 이용할 수 있다. console.log 함수는 자바스크립트 구문에서 사용할 수 있는 디버그 코드로 이클립스 및 Xcode에서 확인 할 수 있다.

console.log의 작성 방법의 예시는 다음과 같다.

function onError(e)
{
    ...
    console.log('Error status: ' + e.status + ' - Error message: ' + e.message);
    ...
}

디버깅 코드가 실행 되면 아래와 같은 메시지를 개발도구의 콘솔 메시지 창에서 볼 수 있다.

웹소스 버전관리 및 배포(WebResourceUpdater) 디바이스 API 가이드 다운로드 : Click