목차

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

개요

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

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

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

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

항목설명비고
OSWindows 10
JDKJava SE SDK 7.0
SDK-APIAndroid 4.4 이상 API 19(Kitkat)이상
IDEEclipse 4.8 (Photon) 구현도구에 포함
Cordovav8.1.2Cordova Device v7.1.4
Eclipse Plug-InAndroid ADT

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

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

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

Step 1. 설치

다운로드

  1. Android SDK Manager : Android SDK Manager Download
  2. ADT Plugin : ADT Plugin Download
  3. Cordova : Cordova Download

개발환경 설치

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



SDK 설치

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

설치방법

유의사항

ADT 설치

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

설치방법

Android Configurator for M2E 플러그인 설치

Cordova 설치

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

설치방법

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

DeviceAPIGuide_Android_V3.5.zip import

  1. 압축파일을 새로운폴더에 해제한다.
  2. Import > Android > Existing Android Application Project

  3. 압축해제한 디렉토리를 지정한후 Copy projets into workspace 체크후 Finish한다.

  4. 프로젝트 내, 전자정부 디바이스API 실행환경 구성

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

  1. 전자 정부 표준프레임워크 센터에서 받은 DeviceAPIGuide_Android_V3.5.zip 파일을 해당 위치에 복사한다. (전자정부 표준 프레임워크 센터 이용하기)
  2. 다운받은 DeviceAPIGuide_Android_V3.5.zip 압축을 푼다.
  3. assets / www 폴더 내에 실행환경의 css를 구성한다.
  4. assets / www 폴더 내에 실행환경의 images를 구성한다.
  5. assets / www 폴더 내에 실행환경의 js를 구성한다.
  6. 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 폴더에 구성한다.
  7. AndroidManifest.xml 및 project.properties를 수정한다. Cordova (Phonegap) 설정

Step 2. 프로젝트 실행

Device Application

  1. 실행환경 예제를 설치한다.실행환경 예제 설치하러 가기
  2. 프로젝트 선택 후, 오른쪽 클릭 > Run As > Android Application

  3. ADT에서 제공하는 Android Virtual Device Manager로 실행

  4. 디바이스의 USB 디버깅 모드로 실행

  5. LogCat을 통해 앱 어플리케이션에 대한 디버그를 확인

Web Application

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.cssquery 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.jsjQuery 의 js 파일
assets/www/js/egovframework/mbl/cmm/jquery.mobile-1.4.5.min.jsjQuery Mobile 의 js 파일
assets/www/js/egovframework/mbl/cmm/jquery.validate.min.jsValidation 관련 js 파일
assets/www/js/egovframework/mbl/cmm/json2.jsjson 관련 js 파일
assets/www/js/egovframework/mbl/cmm/modernizr-3.6.0.jsDevice API 확인을 위한 공통 js 파일
assets/www/js/egovframework/mbl/cmm/swipebutton/jquery-mobile-custom.jsswipebutton 관련 js 파일
libs/cordova.jarCordova (Phonegap) 구성을 위한 각종 클래스와 랩퍼클래스
res/xml/config.xmlCordova Plugin 구성을 위한 설정 XML 파일
AndroidManiFest.xml안드로이드 어플리케이션 설정 XML 파일

구성

유형배포형태다운로드URL관련페이지
다운로드zip 다운로드 바로가기 실행환경 가이드 바로가기
Acceleratorzip다운로드 바로가기 Accelerator 가이드 바로가기
Camerazip 다운로드 바로가기 Camera 가이드 바로가기
Compass zip 다운로드 바로가기 Compass 가이드 바로가기
Contacts zip 다운로드 바로가기 Contacts 가이드 바로가기
Devicezip 다운로드 바로가기 Device 가이드 바로가기
FileReadWriter zip 다운로드 바로가기 FileReadWriter 가이드 바로가기
GPS zip 다운로드 바로가기 GPS 가이드 바로가기
Interfacezip 다운로드 바로가기 Interface 가이드 바로가기
Media zip 다운로드 바로가기 Media 가이드 바로가기
Network zip 다운로드 바로가기 Network 가이드 바로가기
Vibratorzip 다운로드 바로가기 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 가이드 바로가기

관련 환경