모바일 디바이스 API 개발을 위한 Gatting Started ( 지원 Platform : iOS )
개요
본 가이드는 전자정부 표준프레임워크에서 제공하는 모바일 디바이스 API 실행환경, 개발환경, 가이드프로그램의 적용 및 실습을 위한 기본 환경 구축 내용이다. 빠른 시간 내에 모바일 디바이스 API 활용 하이브리드 앱 개발을 위한 기본 기능을 활용하기 위해 3단계 따라하기 방식으로 진행된다.
- 개발환경 설치 : 실습을 위한 개발환경을 구축한다.
- 프로젝트 생성 및 설정 : 제공한 샘플 프로젝트를 이용하여 앱 어플리케이션을 생성하고 웹 어플리케이션을 통해 실행해 본다.
- 자세히 들여보기 : 생성/실행한 프로젝트의 내부 소스코드를 학습하여 전자정부 표준 프레임워크 기반의 웹 어플리케이션과 전자정부 디바이스API 프레임워크 기반의 앱 어플리케이션 구현 원리를 이해한다.
전자정부 표준프레임워크 기반의 웹 어플리케이션과 모바일 디바이스 API 실행환경 기반의 앱 어플리케이션 개발 및 실행을 위한 구현도구의 환경정보는 다음과 같다
| 항목 | 설명 | 비고 |
|---|---|---|
| 운영체제 | Mac OSX 10.9.4 (Mavericks) 이상 | |
| SDK | Cocoa Touch | XCode에 포함 |
| iOS Version | iOS 6.0 이상 | |
| 개발도구 | XCode 6.2 이상 | LLVM컴파일러 내장(GCC개선) |
| 개발가능언어 | Objective-C, C++, Swift | Native |
| Cordova | v4.3 (Phonegap Device 3.8) |
Step 1. 설치
다운로드
개발 환경 설치
1) Finder > 응용프로그램에서 맥용 App Store를 실행한다.
2) xcode를 검색한후 “받기”를 클릭하여 다운로드 받는다. 앱스토어에서 설치까지 자동으로 진행된다.
- XCode는 크기가 5GB 가 넘기 때문에 디스크 용량을 확인한후 설치한다.
3) 라이센스 동의창에서 Agree를 누른다.
3) 남은 설치과정이 진행된다.
4) 설치가 완료되면 Finder를 열어 응용프로그램에서 XCode 생성 여부를 확인한다.
5) 설치시 오류나 기타 사항은 애플 개발자 사이트를 참고한다.
- xCode 참고 : Click
Cordova (Phonegap) 설치
1) 폰갭 사이트에서 인스톨 페이지를 선택한다.
2) 폰갭 버전 4.x 에서는 CLI툴을 이용하여 다운로드 받도록 변경되었다.
3) CLI를 이용한 자세한 다운로드 방법은 폰갭 사이트를 참고한다.
전자 정부 디바이스 API 실행환경 설치
실행환경 구성하기
PhoneGap 업데이트로 프로젝트 생성방식의 변경으로 표준프레임워크 모바일 디바이스 API 2.5버젼에서 제공하였던 xCode 템플릿은 사용할 수 없다.
1) 다운로드.
- 디바이스 API 실행환경 : Click
2) 다운로드 받은 압축파일의 확장자를 .zip으로 변경한다.
3) 압축을 풀고 프로젝트 파일을 더블클릭하여 xCode를 실행한다.
4) 상단의 시뮬레이터 혹은 디바이스를 선택하여 빌드할 대상을 지정한다.
5) xCode 메뉴 Proudct > Menu를 선택하여 빌드가 정상적으로 수행되는지 테스트 한다.
6) xCode 중앙에 빌드 성공여부를 확인 한다.
7) 디바이스에서 테스트할 경우, Apple 개발자 인증서가 있어야 된다. 인증서 취득 과정은
Click에서 참조할 수 있다.
Step 2. 프로젝트 실행
Device Application
- 실행환경 예제를 설치한다.실행환경 예제 설치하러 가기
- 프로젝트에서 대상을 iPhone Simulater로 선택 한뒤 실행 버튼을 누른다
- 통합 Xcode 개발툴 하단에서 어플리케이션에 대한 디버그 메시지를 확인 할수 있다.
실행 화면
Web Application
- Web Application은 전자정부 표준 프레임워크 2.7을 기반으로 만들어진 어플리케이션이므로, 아래를 참고한다.
Step 3. 자세히 들여다 보기
주요 Page
구조
| 디렉토리 | 파일 | 비고 |
|---|---|---|
| www/css/egovframework/mbl/cmm/ | EgoMobile-1.3.2.css | 모바일 실행환경 공통 css 파일 |
| www/css/egovframework/mbl/cmm/ | jquery.mobile-1.3.2css | query mobile 의 css 파일 |
| www/css/egovframework/mbl/cmm/ | theme-1.1.1.css | 테마 파일 |
| www/css/egovframework/mbl/cmm/swipebutton/ | jquery-mobile-custom.css | swipebutton 관련 css 파일 |
| www/js/egovframework/mbl/cmm/ | cordova.min.js | cordova의 js 파일 |
| www/js/egovframework/mbl/cmm/ | EgovComeModuleAPI.js | 디바이스API 공통 js 파일 |
| www/js/egovframework/mbl/cmm/ | EgovMobile-1.3.2.js | 모바일 실행환경의 공통 js 파일 |
| www/js/egovframework/mbl/cmm/ | jquery-1.9.1.min.js | jQuery 의 js 파일 |
| www/js/egovframework/mbl/cmm/ | jquery.mobile-1.1.1.min.js | jQuery Mobile 의 js 파일 |
| www/js/egovframework/mbl/cmm/ | jquery.validate.min.js | Validation 관련 js 파일 |
| www/js/egovframework/mbl/cmm/ | json2.js | json 관련 js 파일 |
| www/js/egovframework/mbl/cmm/ | modernizr-2.0.4.js | Device API 확인을 위한 공통 js 파일 |
| www/js/egovframework/mbl/cmm/swipebutton/ | jquery-mobile-custom.js | swipebutton 관련 js 파일 |
| projectName/Plugins/ | EgovInterface.h | 디바이스API표준 통신 구현 파일 |
| projectName/Plugins/ | EgovInterface.m | 디바이스API표준 통신 구현 파일 |
| projectName/eGovModule/ | EGovComModule.h | 실행환경 통신 모듈 |
| projectName/eGovModule/ | libEGovComModule.a | 실행환경 통신 모듈 |
| projectName/Supporting Files/ | config.xml | phoneGap 설정 파일 |
| projectName/Supporting Files/ | ProjectName-Info.plist | 어플리케이션 설정 파일 |
| CordovaLib.xcodeproj | header | phonegap 프레임워크 |
구성
관련 환경
전자정부 표준프레임워크 라이센스(바로가기)
전자정부 표준프레임워크 활용의 안정성 보장을 위해 위험성을 지속적으로 모니터링하고 있으나, 오픈소스의 특성상 문제가 발생할 수 있습니다.
전자정부 표준프레임워크는 Apache 2.0 라이선스를 따르고 있는 오픈소스 프로그램입니다. Apache 2.0 라이선스에 따라 표준프레임워크를 활용하여 발생된 업무중단, 컴퓨터 고장 또는 오동작으로 인한 손해 등에 대해서 책임이 없습니다.
