이 사이트는 전자정부 표준프레임워크 구버전(1.0 ~ 4.3) 가이드 아카이브입니다. 내용은 더 이상 갱신되지 않습니다. 최신 내용은 최신 버전 문서에서 확인하세요.

모바일 디바이스 API 2.5

Device Info 디바이스API 가이드 프로그램

개요

Device Info 가이드 프로그램은 모바일 디바이스 API 실행환경을 활용하여 하이브리드 앱을 개발 시 참고 및 활용될 수 있도록 구현 된 전자정부 디바이스 API에 대한 가이드 앱으로써, 모바일 스마트 디바이스의 메타 정보를 JavaScript 기반으로 구성 된 DeviceInfoAPI 를 통하여 조회 할 수 있도록 지원한다.
또한, 전자정부 표준프레임워크 기반의 웹 서버 어플리케이션과 연계하여 디바이스 내 메타 정보를 조회하여 서버에 전송하고 조회할수 있는 기능으로 구성되어 있다.

특징

본 가이드 프로그램 에서는 디바이스의 메타 정보 조회 기능의 활용을 가이드 할 수 있도록 디바이스 정보 조회하기, 디바이스 정보 서버에 전송하기, 디바이스 정보 목록을 서버로부터 수신하기 를 제공하고 있다.

기능흐름도

device_기능흐름도.png

기능시퀀스

device.jpg

전제 조건

전제 조건
구분 내용
Local 디바이스 개발 환경Xcode 4.5.2, PhoneGap 2.9.0
서버 사이드 개발 환경전자정부표준프레임워크 개발환경2.7
Mash up Open API 연계N/A
테스트 디바이스 iPhone4
테스트 플랫폼 iOS 5.1
추가 라이브러리 적용스토리지 정보 조회를 위한 추가 플러그인 적용

제약사항

Xcode 4.5에서 실행 시 주의 사항

Xcode 4.5부터 iOS 6, iPhone 5를 지원하는데, 해당 디바이스와 OS를 지원을 할 경우 PhoneGap 1.9.0의 라이브러리는 Xcode 4.4.1에서 컴파일되어 배포되는 라이브러리라 프로젝트 옵션을 조정할 필요가 있다.

1. 옵션 설정
xcode4.5_제약사항1.png

2. armv7s 삭제
xcode4.5_제약사항2.png

크로스 도메인 사용

폰갭에서 특정 외부 도메인이나 외부 도메인의 하위 도메인을 사용해야할 경우,
Supproting Files/config.xml에서 <access origin=“ExternalHosts”/> 항목에 외부 도메인 주소를 추가 설정해야 외부 도메인에 접속할 수 있다.

설명

DeviceInfo 디바이스API 가이드 프로그램은 크게 디바이스 정보 조회하기, 디바이스 정보 서버에 전송하기, 디바이스 정보 목록을 서버로부터 수신하기
기능으로 구성되어 있다.(관련기능 부분참조)

클래스 다이어그램

device_class.jpg

Device Application

관련 소스

관련 소스
유형대상소스명비고
CSSwww/css/egovframwork/mbl/hyb/DeviceInfoAPI.css DeviceInfoAPI 가이드 프로그램 주요 Cascading Style Sheets
IMAGE www/images/egovframwork/mbl/hyb/ DeviceInfoAPI 가이드 프로그램 주요 Image 폴더
JS www/js/egovframwork/mbl/hyb/DeviceInfoAPI.js DeviceInfoAPI가이드 프로그램 주요 JavaScript
RES DeviceAPIGuide_iOS_V1.9/Resources/ DeviceInfoAPI가이드 프로그램 주요 Resource 폴더
PLISTDeviceAPIGuide_iOS_V1.9/DeviceAPIGuide_iOS_V1.9-Info.plist iOS 어플리케이션 설정 파일
HTMLwww/DeviceInfoAPI.htmlDeviceInfoAPI 메인 페이지
HTMLwww/license.htmlDeviceInfoAPI 라이센스 페이지
HTMLwww/overview.htmlDeviceInfoAPI 기능설명 페이지

활용 API

device
  • 모바일 디바이스의 하드웨어 및 소프트웨어 관련 메타 정보를 조회한다.
	var name = device.name;
	var cordova= device.cordova;
	var platform = device.platform;
	var uuid = device.uuid;
	var version = device.version;
device
변수설명비고
name디바이스에 셋팅된 명칭을 반환한다.
cordova어플리케이션에서 사용된 폰갭 버전을 반환한다.
platform모바일 디바이스의 플랫폼 정보를 반환한다.
uuid디바이스 고유의 UUID를 반환한다.
version디바이스의 플랫폼 버전을 반환한다.
Event[batterycritical]
  • 배터리 상태가 Critical 레벨에 도달 했을때 호출되는 콜백함수 정의
window.addEventListener("batterycritical", yourCallbackFunction, false);
Event[batterylow]
  • 배터리 상태가 Low 레벨에 도달 했을때 호출되는 콜백함수 정의
window.addEventListener("batterylow", yourCallbackFunction, false);
Event[batterystatus]
  • 배터리 상태에 변화가 감지되면 호출되는 콜백함수 정의
window.addEventListener("batterystatus", yourCallbackFunction, false);
StorageInfo Plugin API
  • 디바이스의 총 메모리 용량 조회 함수
StorageInfo.totalFileSystemSize(successCallback, failCallback, []);
  • 디바이스의 가용 메모리 용량 조회 함수
StorageInfo.freeFileSystemSize(successCallback, failCallback, []);

Server Application

관련 소스

관련 소스
유형대상소스명비고
Controlleregovframework.hyb.ios.dvc.web.EgovDeviceiOSAPIController.javaDeviceInfoAPI 가이드 프로그램 Controller Class
Serviceegovframework.hyb.ios.dvc.service.EgovDeviceiOSAPIService.javaDeviceInfoAPI 가이드 프로그램 Service Class
ServiceImplegovframework.hyb.ios.dvc.service.impl.EgovDeviceiOSAPIServiceImpl.javaDeviceInfoAPI 가이드 프로그램 ServiceImpl Class
VOegovframework.hyb.ios.dvc.service.DeviceiOSAPIVO.javaDeviceInfoAPI 가이드 프로그램 VO Class
DAOegovframework.hyb.ios.dvc.service.impl.DeviceiOSAPIDAO.javaDeviceInfoAPI 가이드 프로그램 Dao Class
QUERY XMLresources/egovframework/sqlmap/hyb/ios/dvc/EgovDeviceiOSAPIGuide_SQL_[DB명].xmlDeviceInfoAPI 가이드 프로그램 QUERY XML

관련 테이블

관련 테이블
테이블명테이블명(영문)비고
디바이스Device디바이스 정보 관리

테이블 정의서

  • Device
테이블 정의서
No컬럼ID컬럼명타입길이NULL
1SN일련번호NUMERIC6NotNull
2UUIDUUIDVARCHAR50NotNull
3TELNO전화번호VARCHAR20Null
4STRGE_INFO스토리지정보VARCHAR40Null
5LANG언어VARCHAR15Null
6NTWRK_DEVICE_INFO네트워크디바이스정보VARCHAR20Null
7PG_VER폰갭버전VARCHAR40Null
8DEVICE_NM디바이스명VARCHAR200Null
9USEYN활성화여부CHAR1Null

ERD

erd.jpg

환경설정

DeviceInfo 디바이스API 가이드 프로그램에서 제공하는 모바일 디바이스의 메타 정보 조회 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.

Device Application

config.xml

    <feature name="Battery">
         <param name="ios-package" value="CDVBattery"/>
    </feature>
    <feature name="InterfaceAPI">
         <param name="ios-package" value="EgovInterface"/>
    </feature>

[Project Name]/eGovModule/EGovComModule.h

#define kSERVER_URL     @"http://Server Url"

Server Application

resource/egovframework/sqlmap/sql-map-config_[DB명].xml

<sqlMap resource="egovframework/sqlmap/hyb/ios/dvc/EgovDeviceiOSAPIGuide_SQL_[DB명].xml"/>

관련기능

DeviceInfo 디바이스API 가이드 프로그램은 크게 디바이스 내 메타 정보 조회 기능과 조회된 메타 정보를 서버에 전송하고 조회할수 있는 기능으로 구성되어 있다.

디바이스 정보 조회하기

비즈니스 규칙

  • 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.

관련 코드

디바이스 정보 VO
/** 디바이스 정보  VO */
var deviceInfoVO = {     sn : "",
     uuid : "",
     os : "",
     telno : "",
     strgeInfo : "",
     ntwrkDeviceInfo : "",
     pgVer : "",
     deviceNm : "",
     useyn : "" }
디바이스 정보 화면 표시
function fn_egov_load_deviceInfo() {
    deviceInfoVO.ntwrkDeviceInfo = fn_egov_get_networkInfo();

    $('.deviceInfo:eq(0)').html(device.platform + " " + device.version);
    $('.deviceInfo:eq(1)').html(device.uuid);
    $('.deviceInfo:eq(2)').html(device.cordova);
    fn_egov_get_contacts();
    $('.deviceInfo:eq(4)').html(deviceInfoVO.ntwrkDeviceInfo);
    StorageInfo.totalFileSystemSize(fn_egov_totalSpace_success, fn_egov_fail, []);
}
네트워크 정보 조회
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];
    
}
연락처 정보 조회
function fn_egov_get_contactsRead(contacts) 
{
    console.log("[DeviceAPIGuide] fn_egov_get_contactsRead : Success ");
    $('.deviceInfo:eq(3)').html("총 " + contacts.length + "개의 연락처");
    deviceInfoVO.telno = contacts.length;
}
function fn_egov_get_contacts() 
{
    var obj = new ContactFindOptions();
    obj.filter = "";
    obj.multiple = true;
    navigator.contacts.find(
                            [ "displayName", "name" ], 
                            fn_egov_get_contactsRead,
                            fn_egov_get_contactsFail, 
                            obj);
}

관련 화면 및 수행매뉴얼

디바이스정보조회.png

OS: 플랫폼 정보 및 버전
UUID : 디바이스의 고유 아이디
PhoneGap Version : DeviceInfo 가이드 프로그램에 적용된 폰갭 버전
Contacts : 디바이스에 저장된 연락처 갯수
Connection Type : 디바이스의 네트워크 상태 정보
Total Memory : 디바이스의 총 메모리

디바이스 정보 서버에 전송하기

비즈니스 규칙

  • 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
  • 디바이스 정보의 서버 전송은 InterfaceAPI를 이용한다.

관련 코드

디바이스 정보 등록
function fn_egov_regist_deviceInfo() {
    if(!fn_egov_network_check(true)){
        return false;
    }
    

    var params = {uuid :  device.uuid, os : device.platform + " " + device.version,
        telno :  deviceInfoVO.telno, strgeInfo : deviceInfoVO.strgeInfo,
        ntwrkDeviceInfo :  deviceInfoVO.ntwrkDeviceInfo , pgVer : device.cordova};
    
    EgovInterface.submitAsynchronous([params, "/dvc/addDeviceInfo.do"],
                                     function(){
                                        navigator.notification.alert("입력 완료.", null, 'Info');
                                        console.log("[DeviceAPIGuide] fn_egov_regist_deviceInfo : Completed ");
                                     },
                                     function(error) {
                                        $("#alert_dialog").click( function() {
                                                              jAlert('데이터 입력 중 오류가 발생 했습니다.', '입력 오류', 'c');
                                                              });
                                     }
                                     );
    
	
}

관련 화면 및 수행매뉴얼

관련 화면 및 수행매뉴얼
ActionURLController methodQueryID
디바이스 정보 등록/dvc/addDeviceInfo.doinsertDeviceInfo“deviceiOSAPIDAO.insertDeviceInfo”

디바이스정보조회.png

정보 업로드: 디바이스 정보를 서버로 업로드 한다.

디바이스 정보 목록 조회하기

비즈니스 규칙

  • 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.

관련 코드

디바이스 정보 목록 조회
function fn_egov_move_deviceInfoList() {
    if(!fn_egov_network_check(true)){
        return false;
    }
	var params = {uuid : device.uuid };
    
    EgovInterface.submitAsynchronous([params, "/dvc/deviceInfoList.do"],
                                     fn_egov_dispatch_deviceInfoList,
                                     function(error) {
                                     $("#alert_dialog").click( function() {
                                                              jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
                                                              });
                                     }
                                     );
    
    
	
}
function fn_egov_dispatch_deviceInfoList(data){
    
    var list_html = "";
    var totcnt = data.deviceInfoList.length;
    
    for (var i = 0; i < totcnt; i++) {
        result = data.deviceInfoList[i];
        
        list_html += "<li><a href='javascript:fn_egov_request_deviceInfoDetail(" + result.sn + ")'><h3>UUID : " + result.uuid + "</h3>";
        list_html += "<p><strong>Network Connection Type : " + result.ntwrkDeviceInfo + "</strong></p>";
        list_html += "<p>OS : " + result.os + "</p></a></li>";
        
    }
    
    var theList = $('#theList');
    theList.html(list_html);
    
    $.mobile.changePage("#deviceInfoList", "slide", false, false);
    theList.listview("refresh");
    
    console.log("[DeviceAPIGuide] fn_egov_dispatch_deviceInfoList : Completed ");

}
디바이스 정보 상세 조회
function fn_egov_request_deviceInfoDetail(data){
    if(!fn_egov_network_check(true)){
        return false;
    }
	var params = {sn : data };
    
    EgovInterface.submitAsynchronous([params, "/dvc/deviceInfo.do"],
                                     fn_egov_move_deviceInfoDetail,
                                     function(error) {
                                        $("#alert_dialog").click( function() {
                                                              jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
                                                              });
                                     }
                                     );
}
function fn_egov_move_deviceInfoDetail(result){
    
    $('.deviceInfo:eq(6)').html(result.deviceInfo.os);
    $('.deviceInfo:eq(7)').html(result.deviceInfo.uuid);
    $('.deviceInfo:eq(8)').html(result.deviceInfo.pgVer);
    $('.deviceInfo:eq(9)').html("총 " + result.deviceInfo.telno + "개의 연락처");
    $('.deviceInfo:eq(10)').html(result.deviceInfo.ntwrkDeviceInfo);
    $('.deviceInfo:eq(11)').html(result.deviceInfo.strgeInfo + " MiB");
    
    $("#btnDelDeviceInfo").attr("href","javascript:fn_egov_confirm_delete_deviceInfo(" + result.deviceInfo.sn + ");");
    $.mobile.changePage("#deviceInfoDetail", "slide", false, false);
    console.log("[DeviceAPIGuide] fn_egov_move_deviceInfoDetail : Completed ");

}
디바이스 정보 삭제
function fn_egov_confirm_delete_deviceInfo(sn){
	jConfirm('Device 정보를 삭제 하시겠습니까??', '알림', 'c', function(r){
             if(r == true){
			 fn_egov_delete_deviceInfo(sn);
             }else{
             
             }
             
             });	
	
}
function fn_egov_delete_deviceInfo(data){
    
    if(!fn_egov_network_check(true)){
        return false;
    }
    
    console.log("fn_egov_delete_deviceInfo : ");
	var params = {sn : data };
    
    EgovInterface.submitAsynchronous([params, "/dvc/deleteDeviceInfo.do"],
                                     function(result){
                                        navigator.notification.alert("삭제 완료.", null, 'Info');
                                        console.log("[DeviceAPIGuide] fn_egov_delete_deviceInfo : Completed ");
                                        fn_egov_move_deviceInfoList();
                                     },
                                     function(error) {
                                     $("#alert_dialog").click( function() {
                                                              jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
                                                              });
                                     }
                                     );
	
}

관련 화면 및 수행매뉴얼

관련 화면 및 수행매뉴얼
ActionURLController methodQueryID
디바이스 정보 목록 조회/dvc/deviceInfoList.doselectDeviceList“deviceiOSAPIDAO.selectDeviceInfoList”
디바이스 정보 상세 조회/dvc/deviceInfo.doselectDeviceInfo“deviceiOSAPIDAO.selectDeviceInfo”
디바이스 정보 삭제/dvc/deleteDeviceInfo.dodeleteDeviceInfo“deviceiOSAPIDAO.deleteDeviceInfo”

디바이스목록조회.png 디바이스상세조회.png

디바이스 정보 조회 : 디바이스 정보 조회를 요청한다.
목록 : 디바이스 정보 목록 페이지를 호출한다.
삭제 : 디바이스 정보를 삭제한다.

컴파일 디버깅 배포

컴파일

DeviceInfoAPI Device Applicaton 컴파일 방법

  • 왼쪽 상단의 삼각형 버튼을 클릭하면 가이드 프로그램이 빌드되어 아이폰 디바이스에 설치 된다.

compile_device.jpg

  • 빌드가 성공하면 아래와 같은 어플리케이션 실행화면을 확인 할 수 있다.

디바이스정보조회.png

DeviceInfoAPI Server Applicaton 컴파일 방법

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

서버실행.png

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

서버실행결과_콘솔.png

디버깅

디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 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 콘솔 창

cameradebugxcode.png

  • Organizer 로그 창

cameradebugorganizer.png

DeviceInfo 디바이스 API 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다.

디버깅
디버그 코드디버깅 내용
[DeviceAPIGuide] fn_egov_onBatteryStatus : Success 디바이스의 배터리 정보 변경 시
[DeviceAPIGuide] fn_egov_onBatteryLow : Success 디바이스의 배터리 레벨이 로우 상태 진입 시
[DeviceAPIGuide] fn_egov_onBatteryCritical : Success 디바이스의 배터리 레벨이 크리티컬 상태 진입 시
[DeviceAPIGuide] fn_egov_get_contactsRead : Success 디바이스 연락처 갯수 조회 성공 시
[DeviceAPIGuide] fn_egov_get_contactsFail : Fail 디바이스 연락처 갯수 조회 실패 시
[DeviceAPIGuide] fn_egov_totalSpace_success : Success 디바이스의 총 메모리 조회 성공 시
[DeviceAPIGuide] fn_egov_freeSpace_success : Success 디바이스의 가용 메모리 조회 성공 시
[DeviceAPIGuide] fn_egov_fail : Success 공통 Fail 콜백 함수 호출 시
[DeviceAPIGuide] fn_egov_regist_deviceInfo : Completed 디바이스 정보 저장의 성공 수행 시
[DeviceAPIGuide] fn_egov_dispatch_deviceInfoList : Completed 디바이스 정보 목록 조회의 성공 수행 시
[DeviceAPIGuide] fn_egov_move_deviceInfoDetail : Completed 디바이스 정보 상세 조회의 성공 수행 시
[DeviceAPIGuide] fn_egov_delete_deviceInfo : Completed 디바이스의 정보 삭제의 성공 수행 시

배포

DeviceInfo Device Applicaton 다운로드

  • URL 제시

DeviceInfo Server Applicaton 다운로드

  • URL 제시

참고자료

* UX/UI 라이브러리 : jQuery Mobile 새 창 열림
* 배포 : 다운로드 페이지 링크
* Hybrid : PhoneGap 새 창 열림 \\

Device Info 디바이스API 가이드 프로그램

개요

Device Info 가이드 프로그램은 모바일 디바이스 API 실행환경을 활용하여 하이브리드 앱을 개발 시 참고 및 활용될 수 있도록 구현 된 전자정부 디바이스 API에 대한 가이드 앱 으로써, 모바일 스마트 디바이스의 메타 정보를 JavaScript 기반으로 구성 된 DeviceInfoAPI 를 통하여 조회 할 수 있도록 지원한다.
또한, 전자정부 표준프레임워크 기반의 웹 서버 어플리케이션과 연계하여 디바이스 내 메타 정보를 조회하여 서버에 전송하고 조회할수 있는 기능으로 구성되어 있다.

특징

본 가이드 프로그램 에서는 디바이스의 메타 정보 조회 기능의 활용을 가이드 할 수 있도록 디바이스 정보 조회하기, 디바이스 정보 서버에 전송하기, 디바이스 정보 목록을 서버로부터 수신하기 를 제공하고 있다.

기능흐름도

device_기능흐름도.png

기능시퀀스

device.jpg

전제 조건

전제 조건
구분 내용
Local 디바이스 개발 환경Xcode 4.4.1, PhoneGap 1.9.0
서버 사이드 개발 환경전자정부표준프레임워크 개발환경2.1
Mash up Open API 연계N/A
테스트 디바이스 iPhone4
테스트 플랫폼 iOS 5.1
추가 라이브러리 적용스토리지 정보 조회를 위한 추가 플러그인 적용

제약사항

Xcode 4.5에서 실행 시 주의 사항

Xcode 4.5부터 iOS 6, iPhone 5를 지원하는데, 해당 디바이스와 OS를 지원을 할 경우 PhoneGap 1.9.0의 라이브러리는 Xcode 4.4.1에서 컴파일되어 배포되는 라이브러리라 프로젝트 옵션을 조정할 필요가 있다.

1. 옵션 설정
xcode4.5_제약사항1.png

2. armv7s 삭제
xcode4.5_제약사항2.png

설명

DeviceInfo 디바이스API 가이드 프로그램은 크게 디바이스 정보 조회하기, 디바이스 정보 서버에 전송하기, 디바이스 정보 목록을 서버로부터 수신하기
기능으로 구성되어 있다.(관련기능 부분참조)

클래스 다이어그램

device_class.jpg

Device Application

관련 소스
관련 소스
유형대상소스명비고
CSSwww/css/egovframwork/mbl/hyb/DeviceInfoAPI.css DeviceInfoAPI 가이드 프로그램 주요 Cascading Style Sheets
IMAGE www/images/egovframwork/mbl/hyb/ DeviceInfoAPI 가이드 프로그램 주요 Image 폴더
JS www/js/egovframwork/mbl/hyb/DeviceInfoAPI.js DeviceInfoAPI가이드 프로그램 주요 JavaScript
RES DeviceAPIGuide_iOS_V1.9/Resources/ DeviceInfoAPI가이드 프로그램 주요 Resource 폴더
PLISTDeviceAPIGuide_iOS_V1.9/DeviceAPIGuide_iOS_V1.9-Info.plist iOS 어플리케이션 설정 파일
HTMLwww/DeviceInfoAPI.htmlDeviceInfoAPI 메인 페이지
HTMLwww/license.htmlDeviceInfoAPI 라이센스 페이지
HTMLwww/overview.htmlDeviceInfoAPI 기능설명 페이지
활용 API
device
  • 모바일 디바이스의 하드웨어 및 소프트웨어 관련 메타 정보를 조회한다.
	var name = device.name;
	var cordova= device.cordova;
	var platform = device.platform;
	var uuid = device.uuid;
	var version = device.version;
device
변수설명비고
name디바이스에 셋팅된 명칭을 반환한다.
cordova어플리케이션에서 사용된 폰갭 버전을 반환한다.
platform모바일 디바이스의 플랫폼 정보를 반환한다.
uuid디바이스 고유의 UUID를 반환한다.
version디바이스의 플랫폼 버전을 반환한다.
Event[batterycritical]
  • 배터리 상태가 Critical 레벨에 도달 했을때 호출되는 콜백함수 정의
window.addEventListener("batterycritical", yourCallbackFunction, false);
Event[batterylow]
  • 배터리 상태가 Low 레벨에 도달 했을때 호출되는 콜백함수 정의
window.addEventListener("batterylow", yourCallbackFunction, false);
Event[batterystatus]
  • 배터리 상태에 변화가 감지되면 호출되는 콜백함수 정의
window.addEventListener("batterystatus", yourCallbackFunction, false);
StorageInfo Plugin API
  • 디바이스의 총 메모리 용량 조회 함수
StorageInfo.totalFileSystemSize(successCallback, failCallback, []);
  • 디바이스의 가용 메모리 용량 조회 함수
StorageInfo.freeFileSystemSize(successCallback, failCallback, []);

Server Application

관련 소스
관련 소스
유형대상소스명비고
Controlleregovframework.hyb.ios.dvc.web.EgovDeviceiOSAPIController.javaDeviceInfoAPI 가이드 프로그램 Controller Class
Serviceegovframework.hyb.ios.dvc.service.EgovDeviceiOSAPIService.javaDeviceInfoAPI 가이드 프로그램 Service Class
ServiceImplegovframework.hyb.ios.dvc.service.impl.EgovDeviceiOSAPIServiceImpl.javaDeviceInfoAPI 가이드 프로그램 ServiceImpl Class
VOegovframework.hyb.ios.dvc.service.DeviceiOSAPIVO.javaDeviceInfoAPI 가이드 프로그램 VO Class
DAOegovframework.hyb.ios.dvc.service.impl.DeviceiOSAPIDAO.javaDeviceInfoAPI 가이드 프로그램 Dao Class
QUERY XMLresources/egovframework/sqlmap/hyb/ios/dvc/EgovDeviceiOSAPIGuide_SQL_[DB명].xmlDeviceInfoAPI 가이드 프로그램 QUERY XML
관련 테이블
관련 테이블
테이블명테이블명(영문)비고
디바이스Device디바이스 정보 관리
테이블 정의서
  • Device
테이블 정의서
No컬럼ID컬럼명타입길이NULL
1SN일련번호NUMERIC6NotNull
2UUIDUUIDVARCHAR50NotNull
3TELNO전화번호VARCHAR20Null
4STRGE_INFO스토리지정보VARCHAR40Null
5LANG언어VARCHAR15Null
6NTWRK_DEVICE_INFO네트워크디바이스정보VARCHAR20Null
7PG_VER폰갭버전VARCHAR40Null
8DEVICE_NM디바이스명VARCHAR200Null
9USEYN활성화여부CHAR1Null
ERD

erd.jpg

환경설정

DeviceInfo 디바이스API 가이드 프로그램에서 제공하는 모바일 디바이스의 메타 정보 조회 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.

Device Application

Cordova.plist
<key>Battery</key>
<string>CDVBattery</string>
<key>InterfaceAPI</key>
<string>EgovInterface</string>
DeviceAPIGuide_iOS_V1.9/eGovModule/EGovComModule.h
#define kSERVER_URL     @"http://192.168.100.222:8080/DeviceAPIGuideTotal_Web_V1.7"

Server Application

resource/egovframework/sqlmap/sql-map-config_[DB명].xml
<sqlMap resource="egovframework/sqlmap/hyb/ios/dvc/EgovDeviceiOSAPIGuide_SQL_[DB명].xml"/>

관련기능

DeviceInfo 디바이스API 가이드 프로그램은 크게 디바이스 내 메타 정보 조회 기능과 조회된 메타 정보를 서버에 전송하고 조회할수 있는 기능으로 구성되어 있다.

디바이스 정보 조회하기

비즈니스 규칙
  • 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
관련 코드
디바이스 정보 VO
/** 디바이스 정보  VO */
var deviceInfoVO = {     sn : "",
     uuid : "",
     os : "",
     telno : "",
     strgeInfo : "",
     ntwrkDeviceInfo : "",
     pgVer : "",
     deviceNm : "",
     useyn : "" }
디바이스 정보 화면 표시
function fn_egov_load_deviceInfo() {
    deviceInfoVO.ntwrkDeviceInfo = fn_egov_get_networkInfo();

    $('.deviceInfo:eq(0)').html(device.platform + " " + device.version);
    $('.deviceInfo:eq(1)').html(device.uuid);
    $('.deviceInfo:eq(2)').html(device.cordova);
    fn_egov_get_contacts();
    $('.deviceInfo:eq(4)').html(deviceInfoVO.ntwrkDeviceInfo);
    StorageInfo.totalFileSystemSize(fn_egov_totalSpace_success, fn_egov_fail, []);
}
네트워크 정보 조회
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];
    
}
연락처 정보 조회
function fn_egov_get_contactsRead(contacts) 
{
    console.log("[DeviceAPIGuide] fn_egov_get_contactsRead : Success ");
    $('.deviceInfo:eq(3)').html("총 " + contacts.length + "개의 연락처");
    deviceInfoVO.telno = contacts.length;
}
function fn_egov_get_contacts() 
{
    var obj = new ContactFindOptions();
    obj.filter = "";
    obj.multiple = true;
    navigator.contacts.find(
                            [ "displayName", "name" ], 
                            fn_egov_get_contactsRead,
                            fn_egov_get_contactsFail, 
                            obj);
}
관련 화면 및 수행매뉴얼

디바이스정보조회.png

OS: 플랫폼 정보 및 버전
UUID : 디바이스의 고유 아이디
PhoneGap Version : DeviceInfo 가이드 프로그램에 적용된 폰갭 버전
Contacts : 디바이스에 저장된 연락처 갯수
Connection Type : 디바이스의 네트워크 상태 정보
Total Memory : 디바이스의 총 메모리

디바이스 정보 서버에 전송하기

비즈니스 규칙
  • 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
  • 디바이스 정보의 서버 전송은 InterfaceAPI를 이용한다.
관련 코드
디바이스 정보 등록
function fn_egov_regist_deviceInfo() {
    if(!fn_egov_network_check(true)){
        return false;
    }
    

    var params = {uuid :  device.uuid, os : device.platform + " " + device.version,
        telno :  deviceInfoVO.telno, strgeInfo : deviceInfoVO.strgeInfo,
        ntwrkDeviceInfo :  deviceInfoVO.ntwrkDeviceInfo , pgVer : device.cordova};
    
    EgovInterface.submitAsynchronous([params, "/dvc/addDeviceInfo.do"],
                                     function(){
                                        navigator.notification.alert("입력 완료.", null, 'Info');
                                        console.log("[DeviceAPIGuide] fn_egov_regist_deviceInfo : Completed ");
                                     },
                                     function(error) {
                                        $("#alert_dialog").click( function() {
                                                              jAlert('데이터 입력 중 오류가 발생 했습니다.', '입력 오류', 'c');
                                                              });
                                     }
                                     );
    
	
}
관련 화면 및 수행매뉴얼
관련 화면 및 수행매뉴얼
ActionURLController methodQueryID
디바이스 정보 등록/dvc/addDeviceInfo.doinsertDeviceInfo“deviceiOSAPIDAO.insertDeviceInfo”

디바이스정보조회.png

정보 업로드: 디바이스 정보를 서버로 업로드 한다.

디바이스 정보 목록 조회하기

비즈니스 규칙
  • 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
관련 코드
디바이스 정보 목록 조회
function fn_egov_move_deviceInfoList() {
    if(!fn_egov_network_check(true)){
        return false;
    }
	var params = {uuid : device.uuid };
    
    EgovInterface.submitAsynchronous([params, "/dvc/deviceInfoList.do"],
                                     fn_egov_dispatch_deviceInfoList,
                                     function(error) {
                                     $("#alert_dialog").click( function() {
                                                              jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
                                                              });
                                     }
                                     );
    
    
	
}
function fn_egov_dispatch_deviceInfoList(data){
    
    var list_html = "";
    var totcnt = data.deviceInfoList.length;
    
    for (var i = 0; i < totcnt; i++) {
        result = data.deviceInfoList[i];
        
        list_html += "<li><a href='javascript:fn_egov_request_deviceInfoDetail(" + result.sn + ")'><h3>UUID : " + result.uuid + "</h3>";
        list_html += "<p><strong>Network Connection Type : " + result.ntwrkDeviceInfo + "</strong></p>";
        list_html += "<p>OS : " + result.os + "</p></a></li>";
        
    }
    
    var theList = $('#theList');
    theList.html(list_html);
    
    $.mobile.changePage("#deviceInfoList", "slide", false, false);
    theList.listview("refresh");
    
    console.log("[DeviceAPIGuide] fn_egov_dispatch_deviceInfoList : Completed ");

}
디바이스 정보 상세 조회
function fn_egov_request_deviceInfoDetail(data){
    if(!fn_egov_network_check(true)){
        return false;
    }
	var params = {sn : data };
    
    EgovInterface.submitAsynchronous([params, "/dvc/deviceInfo.do"],
                                     fn_egov_move_deviceInfoDetail,
                                     function(error) {
                                        $("#alert_dialog").click( function() {
                                                              jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
                                                              });
                                     }
                                     );
}
function fn_egov_move_deviceInfoDetail(result){
    
    $('.deviceInfo:eq(6)').html(result.deviceInfo.os);
    $('.deviceInfo:eq(7)').html(result.deviceInfo.uuid);
    $('.deviceInfo:eq(8)').html(result.deviceInfo.pgVer);
    $('.deviceInfo:eq(9)').html("총 " + result.deviceInfo.telno + "개의 연락처");
    $('.deviceInfo:eq(10)').html(result.deviceInfo.ntwrkDeviceInfo);
    $('.deviceInfo:eq(11)').html(result.deviceInfo.strgeInfo + " MiB");
    
    $("#btnDelDeviceInfo").attr("href","javascript:fn_egov_confirm_delete_deviceInfo(" + result.deviceInfo.sn + ");");
    $.mobile.changePage("#deviceInfoDetail", "slide", false, false);
    console.log("[DeviceAPIGuide] fn_egov_move_deviceInfoDetail : Completed ");

}
디바이스 정보 삭제
function fn_egov_confirm_delete_deviceInfo(sn){
	jConfirm('Device 정보를 삭제 하시겠습니까??', '알림', 'c', function(r){
             if(r == true){
			 fn_egov_delete_deviceInfo(sn);
             }else{
             
             }
             
             });	
	
}
function fn_egov_delete_deviceInfo(data){
    
    if(!fn_egov_network_check(true)){
        return false;
    }
    
    console.log("fn_egov_delete_deviceInfo : ");
	var params = {sn : data };
    
    EgovInterface.submitAsynchronous([params, "/dvc/deleteDeviceInfo.do"],
                                     function(result){
                                        navigator.notification.alert("삭제 완료.", null, 'Info');
                                        console.log("[DeviceAPIGuide] fn_egov_delete_deviceInfo : Completed ");
                                        fn_egov_move_deviceInfoList();
                                     },
                                     function(error) {
                                     $("#alert_dialog").click( function() {
                                                              jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
                                                              });
                                     }
                                     );
	
}
관련 화면 및 수행매뉴얼
관련 화면 및 수행매뉴얼
ActionURLController methodQueryID
디바이스 정보 목록 조회/dvc/deviceInfoList.doselectDeviceList“deviceiOSAPIDAO.selectDeviceInfoList”
디바이스 정보 상세 조회/dvc/deviceInfo.doselectDeviceInfo“deviceiOSAPIDAO.selectDeviceInfo”
디바이스 정보 삭제/dvc/deleteDeviceInfo.dodeleteDeviceInfo“deviceiOSAPIDAO.deleteDeviceInfo”

디바이스목록조회.png 디바이스상세조회.png

디바이스 정보 조회 : 디바이스 정보 조회를 요청한다.
목록 : 디바이스 정보 목록 페이지를 호출한다.
삭제 : 디바이스 정보를 삭제한다.

컴파일 디버깅 배포

컴파일

DeviceInfoAPI Device Applicaton 컴파일 방법
  • 왼쪽 상단의 삼각형 버튼을 클릭하면 가이드 프로그램이 빌드되어 아이폰 디바이스에 설치 된다.

compile_device.jpg

  • 빌드가 성공하면 아래와 같은 어플리케이션 실행화면을 확인 할 수 있다.

디바이스정보조회.png

DeviceInfoAPI Server Applicaton 컴파일 방법
  1. 프로젝트 우클릭>Run as>Maven install 을 클릭하여 빌드를 한다.
    웹서버빌드.png
  2. 빌드 성공 (콘솔 정보 확인)
    웹서버빌드성공.png
  3. 프로젝트 우클릭>Run as>Run on Server 를 클릭하여 실행시킨다.
    웹서버실행.png
  4. 프로젝트가 성공적으로 실행되었는지 확인한다.
    웹서버실행성공.png

디버깅

디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 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 콘솔 창

cameradebugxcode.png

  • Organizer 로그 창

cameradebugorganizer.png

DeviceInfo 디바이스 API 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다.

디버깅
디버그 코드디버깅 내용
[DeviceAPIGuide] fn_egov_onBatteryStatus : Success 디바이스의 배터리 정보 변경 시
[DeviceAPIGuide] fn_egov_onBatteryLow : Success 디바이스의 배터리 레벨이 로우 상태 진입 시
[DeviceAPIGuide] fn_egov_onBatteryCritical : Success 디바이스의 배터리 레벨이 크리티컬 상태 진입 시
[DeviceAPIGuide] fn_egov_get_contactsRead : Success 디바이스 연락처 갯수 조회 성공 시
[DeviceAPIGuide] fn_egov_get_contactsFail : Fail 디바이스 연락처 갯수 조회 실패 시
[DeviceAPIGuide] fn_egov_totalSpace_success : Success 디바이스의 총 메모리 조회 성공 시
[DeviceAPIGuide] fn_egov_freeSpace_success : Success 디바이스의 가용 메모리 조회 성공 시
[DeviceAPIGuide] fn_egov_fail : Success 공통 Fail 콜백 함수 호출 시
[DeviceAPIGuide] fn_egov_regist_deviceInfo : Completed 디바이스 정보 저장의 성공 수행 시
[DeviceAPIGuide] fn_egov_dispatch_deviceInfoList : Completed 디바이스 정보 목록 조회의 성공 수행 시
[DeviceAPIGuide] fn_egov_move_deviceInfoDetail : Completed 디바이스 정보 상세 조회의 성공 수행 시
[DeviceAPIGuide] fn_egov_delete_deviceInfo : Completed 디바이스의 정보 삭제의 성공 수행 시

배포

DeviceInfo 디바이스 API 가이드 다운로드 : Click 새 창 열림

참고자료

* UX/UI 라이브러리 : jQuery Mobile 새 창 열림
* Hybrid : PhoneGap 새 창 열림

원본 페이지 ID
egovframework:hyb:guide:ios:device
원본 수정일