전자정부 모바일 디바이스 API 개발을 위한 Gatting Started ( 지원 Platform : Android )

전자정부 모바일 디바이스 API 개발을 위한 Gatting Started ( 지원 Platform : Android )

개요

본 가이드는 전자정부 표준 프레임워크에서 제공하는 모바일 디바이스 API 실행환경, 개발환경, 가이드프로그램의 적용 및 실습을 위한 기본 환경 구축 내용이다.

빠른 시간 내에 전자정부 디바이스 API 활용 하이브리드 앱 개발을 위한 기본 기능을 활용하기 위해 3단계 따라하기 방식으로 진행된다.

개발환경 설치 : 실습을 위한 개발환경을 구축한다.
프로젝트 실행 : 제공한 샘플 프로젝트를 이용하여 앱 어플리케이션을 생성하고 웹 어플리케이션을 통해 실행해 본다.
자세히 들여보기 : 생성/실행한 프로젝트의 내부 소스코드를 학습하여 전자정부 표준 프레임워크 기반의 웹 어플리케이션과 전자정부 디바이스API 프레임워크 기반의 앱 어플리케이션 구현 원리를 이해한다.

전자정부 표준 프레임워크 기반의 웹 어플리케이션과 전자정부 디바이스API 프레임워크 기반의 앱 어플리케이션 개발 및 실행을 위한 구현도구의 환경정보는 다음과 같다

항목	설명	비고
OS	Windows 10
JDK	Java SE SDK 7.0
SDK-API	Android 4.4 이상	API 19(Kitkat)이상
IDE	Eclipse 4.8 (Photon)	구현도구에 포함
Cordova	v8.1.2	Cordova Device v7.1.4
Eclipse Plug-In	Android ADT

Eclipse 기반 안드로이드 개발환경 사용시 제약사항

Android SDK Build-tools 지원 버전의 제약이 있으며 지원하는 JDK의 버전도 제약이 따른다.
DeviceAPI v3.9 이후 버전부터는 Android Studio IDE 사용을 권장한다.

항목	설명	비고
JDK	Java SE SDK 7.0	JDK 8.0 미지원
SDK-Build-Tools	v25.0.3 이하 호환가능	v25.0.3 초과하는 버전은 빌드 불가
aar 라이브러리 지원	미지원	jar 라이브러리만 지원
macOS Catalina 호환	SDK-Build-Tools v24.0.0 이상 필요	v23.0.1 및 v23.0.3 사용시 aapt 오류 발생

Step 1. 설치

다운로드

IDE : Eclipse Classic Download
Android SDK Manager : Android SDK Manager Download
ADT Plugin : ADT Plugin Download
Cordova : Cordova Download

개발환경 설치

인터넷 웹브라우저를 통해 eGovFrame 홈페이지(https://www.egovframe.go.kr/)에 접속하여 사이트 상위메뉴를 통해 “다운로드>개발환경”으로 이동 후 개발환경을 다운로드 받는다.

SDK 설치

Android SDK는 SDK Manager를 설치 후, SDK를 설치하게 된다.
자세한 사항은 아래의 설치방법을 참고하도록 한다.

설치방법

유의사항

SDK 경로는 한글이나 공백이 들어가서는 안된다.
API는 필요한 버전을 설치하도록 하며, 전자정부 디바이스API 개발에서는 Android 2.2 이상을 지원하고 있다.

ADT 설치

Android Development Toolkit(이하 ADT)는 Eclipse IDE에서 Android 개발을 도와주기 위한 플러그인 이다. 자세한 사항은 아래의 설치방법을 참고하도록 한다.

설치방법

Android Configurator for M2E 플러그인 설치

ADT와 M2Eclipse Maven 플러그인 연결을 위한 플러그인이다.
Maven 업데이트를 완료한 후에 플러그인 설치를 하여야한다.
Android Configurator for M2E 설치

Cordova 설치

전자정부 디바이스API에서 참조하고 있는 Cordova를 설치한다. 자세한 사항은 아래의 설치방법을 참고하도록 한다.

설치방법

전자정부 디바이스API 실행환경 설치

DeviceAPIGuide_Android_V3.5.zip import

압축파일을 새로운폴더에 해제한다.
Import > Android > Existing Android Application Project
압축해제한 디렉토리를 지정한후 Copy projets into workspace 체크후 Finish한다.
프로젝트 내, 전자정부 디바이스API 실행환경 구성

기존 프로젝트에 실행환경 구성

전자 정부 표준프레임워크 센터에서 받은 DeviceAPIGuide_Android_V3.5.zip 파일을 해당 위치에 복사한다. (전자정부 표준 프레임워크 센터 이용하기)
다운받은 DeviceAPIGuide_Android_V3.5.zip 압축을 푼다.
assets / www 폴더 내에 실행환경의 css를 구성한다.
assets / www 폴더 내에 실행환경의 images를 구성한다.
assets / www 폴더 내에 실행환경의 js를 구성한다.
cordovalib_4.3_v3.7.1.jar, spring-android-core-1.0.0.RELEASE.jar, spring-android-rest-template-1.0.0.RELEASE.jar 를 libs 폴더에 구성한다.
AndroidManifest.xml 및 project.properties를 수정한다. Cordova (Phonegap) 설정

Step 2. 프로젝트 실행

Device Application

실행환경 예제를 설치한다.실행환경 예제 설치하러 가기
프로젝트 선택 후, 오른쪽 클릭 > Run As > Android Application
ADT에서 제공하는 Android Virtual Device Manager로 실행
디바이스의 USB 디버깅 모드로 실행
LogCat을 통해 앱 어플리케이션에 대한 디버그를 확인

Web Application

Web Application은 전자정부 표준 프레임워크 3.9을 기반으로 만들어진 어플리케이션이므로, 아래를 참고한다.
전자정부 표준 프레임워크 3.9 보러가기

Step 3. 자세히 들여다보기

주요 Page

구조

디렉토리	파일	비고
assets/www/css/egovframework/mbl/cmm/	EgoMobile-1.4.5.css	모바일 실행환경 공통 css 파일
assets/www/css/egovframework/mbl/cmm/	jquery.mobile-1.4.5.css	query mobile 의 css 파일
assets/www/css/egovframework/mbl/cmm/	theme-1.1.1.css	테마 파일
assets/www/css/egovframework/mbl/cmm/swipebutton/	jquery-mobile-custom.css	swipebutton 관련 css 파일
assets/www/js/egovframework/mbl/cmm/	cordova.js	cordova의 js 파일
assets/www/js/egovframework/mbl/cmm/	EgovHybrid.js	디바이스API 공통 js 파일
assets/www/js/egovframework/mbl/cmm/	EgovMobile-1.4.6.js	모바일 실행환경의 공통 js 파일
assets/www/js/egovframework/mbl/cmm/	jquery-2.1.14.min.js	jQuery 의 js 파일
assets/www/js/egovframework/mbl/cmm/	jquery.mobile-1.4.5.min.js	jQuery Mobile 의 js 파일
assets/www/js/egovframework/mbl/cmm/	jquery.validate.min.js	Validation 관련 js 파일
assets/www/js/egovframework/mbl/cmm/	json2.js	json 관련 js 파일
assets/www/js/egovframework/mbl/cmm/	modernizr-3.6.0.js	Device API 확인을 위한 공통 js 파일
assets/www/js/egovframework/mbl/cmm/swipebutton/	jquery-mobile-custom.js	swipebutton 관련 js 파일
libs/	cordova.jar	Cordova (Phonegap) 구성을 위한 각종 클래스와 랩퍼클래스
res/xml/	config.xml	Cordova Plugin 구성을 위한 설정 XML 파일
	AndroidManiFest.xml	안드로이드 어플리케이션 설정 XML 파일

구성

유형	배포형태	다운로드URL	관련페이지
다운로드	zip	다운로드 바로가기	실행환경 가이드 바로가기
Accelerator	zip	다운로드 바로가기	Accelerator 가이드 바로가기
Camera	zip	다운로드 바로가기	Camera 가이드 바로가기
Compass	zip	다운로드 바로가기	Compass 가이드 바로가기
Contacts	zip	다운로드 바로가기	Contacts 가이드 바로가기
Device	zip	다운로드 바로가기	Device 가이드 바로가기
FileReadWriter	zip	다운로드 바로가기	FileReadWriter 가이드 바로가기
GPS	zip	다운로드 바로가기	GPS 가이드 바로가기
Interface	zip	다운로드 바로가기	Interface 가이드 바로가기
Media	zip	다운로드 바로가기	Media 가이드 바로가기
Network	zip	다운로드 바로가기	Network 가이드 바로가기
Vibrator	zip	다운로드 바로가기	Vibrator 가이드 바로가기
PushNotifications	zip	다운로드 바로가기	PushNotifications 가이드 바로가기
FileOpener	zip	다운로드 바로가기	FileOpener 가이드 바로가기
StreamingMedia	zip	다운로드 바로가기	StreamingMedia 가이드 바로가기
Barcodescanner	zip	다운로드 바로가기	Barcodescanner 가이드 바로가기
WebResourceUpdate	zip	다운로드 바로가기	WebResourceUpdate 가이드 바로가기
DeviceFileMgmt	zip	다운로드 바로가기	DeviceFileMgmt 가이드 바로가기
JailbreakDetection	zip	다운로드 바로가기	JailbreakDetection 가이드 바로가기
SocketIO	zip	다운로드 바로가기	SocketIO 가이드 바로가기
SQLite	zip	다운로드 바로가기	SQLite 가이드 바로가기
Unzip	zip	다운로드 바로가기	Unzip 가이드 바로가기