¶ 프로젝트
¶ 1. 프로젝트 생성
Morpheus Project Wizard를 통해 신규 프로젝트를 생성 하게 됩니다. Morpheus Project Wizard를 호출 하는 방법은 다음과 같습니다.
- Welcome 화면 중 Projects -> Morpheus Project 선택
- 상단 메뉴 중 File → New → New Morpheus Project 선택
프로젝트 생성을 선택하면 프로젝트 기본 정보를 입력하는 첫 번째 페이지가 호출 됩니다. 각 입력 항목들에 대한 설명은 다음과 같습니다.
-
라이선스 정보 : 앱에 적용할 라이선스를 선택합니다. 만약 라이선스가 없을 경우 교육용 라이선스를 선택하여 앱을 생성할 수 있고 발급받은 라이선스가 존재한다면 추가하기 버튼을 눌러 라이선스를 추가한 후 선택 할 수 있습니다. 라이센스가 선택되면 라이센스에서 정의하고 있는 앱 아이디가 자동으로 안드로이드 패키지 이름, iOS 번들 아이디에 적용됩니다.
-
Templates : 생성될 템플릿 프로젝트의 유형을 선택할수 있습니다.
- Android : Android template 유형을 선택할 수 있습니다.
Morpheus Android Java Template, Morpheus Android Kotline 템플릿 - IOS : iOS template 유형을 선택할 수 있습니다.
Morpheus iOS Objective-C 템플릿, Morpheus iOS Swift 템플릿 - Web : Web template 유형을 선택할 수 있습니다.
Morpheus Web Empty 템플릿, Morpheus Web Guide 템플릿, Morpheus Web React 템플릿, Morpheus Web Vue 템플릿
- Android : Android template 유형을 선택할 수 있습니다.
-
동일한 애플리케이션 정보 사용하기 : 애플리케이션 정보 중 동일한 애플리케이션 정보 사용하기 선택 시에는 Android, iOS 서로 동일한 애플리케이션 이름을 사용합니다.
-
서로 다른 애플리케이션 정보 사용하기 : 애플리케이션 정보 중 서로 다른 애플리케이션 정보 사용하기 선택 시에는 Android, iOS 각각 서로 다른 애플리케이션 이름을 사용합니다. (교육용 라이센스의 경우 선택되지 않습니다)
-
애플리케이션 ID : 애플리케이션 ID 는 Google play 와 App Store에서 앱을 등록하기 위한 고유 식별자 입니다.
-
애플리케이션 이름 : Android 애플리케이션 이름을 입력합니다. 기기에 설치되면, 표시되는 앱 이름입니다.
-
iOS 애플리케이션 이름 : iOS 애플리케이션 이름을 입력합니다. 기기에 설치되면, 표시되는 앱 이름입니다..
-
MSDK Manager 열기 : MSDK Manager 를 실행 시킵니다. 템플릿이 설치되어있지 않거나 라이브러리를 관리하고 싶을 경우 MSDK Manager 를 통해 관리 합니다.
첫 페이지에 입력할 정보들을 모두 입력했으면 하단의 Next 버튼을 눌러 다음단계로 넘어갑니다.
다음은 위 그림과 같은 프로젝트에 적용할 라이브러리를 선택하는 화면입니다.
local 에 다운로드된 라이브러리 목록이 보여집니다.
-
core : 코어 라이브러리 필수항목으로 선택을 해제할수 없습니다.
-
addon : 애드온 라이브러리는 필요에 따라 선택적으로 사용할 수 있으며, 전체 선택하여 사용하는 것을 권장합니다.
-
plugin : 플러그인 라이브러리는 플랫폼에서 제공하는 플러그인 라이브러리가 표시되는 영역으로 Native 제어가 필요한 부분에 대해, 미리 Plug-In화 하여 제공합니다. 플러그인이 필요한 사항은 게시판(컨설팅팀)을 통해 요청이 가능하며 플러그인 개발 여부 및 개발일정은 자체 일정을 감안하여, 판단합니다. 늦어지는 경우, 프로젝트 조직에서 자체 개발이 필요할 수 있습니다.
라이브러리를 모두 적용 했으면 Next 버튼을 눌러 다음단계로 넘어갑니다.
다음은 위 그림과 같은 프로젝트의 이름과 경로를 설정하는 화면입니다.
-
Project name : 프로젝트의 이름을 입력합니다.
-
Project location : 프로젝트가 생성될 위치를 지정합니다.
모든 설정이 끝난 후 Create 버튼을 누르면 설정정보를 반영한 프로젝트가 생성됩니다.
¶ 2. 프로젝트 구조
프로젝트는 하이브리드 앱을 만들기 위한 파일 구조로 Android, iOS, 리소스 + 프레임워크 파일 + 화면을 구성하는 HTML, Javascript 파일로 구성됩니다. Morpheus Project Wizard를 통해 프로젝트가 생성되면 아래 그림과 같이 왼쪽에 위치한 Project Explorer에서 프로젝트를 확인할 수 있습니다.
프로젝트 트리를 열어보면 위 그림과 같은 구조를 확인할 수 있습니다. 각 파일들은 다음과 같은 역할을 합니다.
¶ 1) android
안드로이드 앱을 위한 파일이 위치해 있습니다.
-
android/app/build : 앱을 빌드할 때 결과(dependencies, library, native source, apk, aar, aab 등)가 생성되는 위치입니다.
-
android/app/libs : 라이브러리들이 포함되는 위치입니다. 제품의 라이센스, jni, 외부 라이브러리를 참조도록 할 수 있습니다.
-
android/app/src/androidTest : 안드로이드 단말기에서 단위 테스트를 위한 JUnit 테스트 코드를 작성할 수 있는 위치입니다.
-
android/app/src/main : 안드로이드 기본 소스 세트가 포함되는 위치입니다.
-
android/app/src/main/AndroidManifest.xml : 애플리케이션의 특성 및 구성요소를 설정합니다.
-
android/app/src/main/assets : apk파일에 그대로 포함될 파일을 포함하는 위치입니다.
-
android/app/src/main/java : java또는 kotlin 등의 파일이 포함되는 경로입니다.
-
android/app/src/main/res : 안드로이드 애플리케이션의 리소스(xml,image 등)를 포함하는 위치입니다.
-
android/app/build.gradle : 안드로이드 애플리케이션의 빌드 구성을 정의합니다.
-
android/app/morpheus.gradle : 모피어스 라이브러리 모듈이 선언되어 있습니다.
¶ 2) assets
화면을 구성하는 HTML, Javascript, img, js 파일이 위치하게 됩니다. assets 폴더를 열어서 내부를 살펴보면 아래 그림과 같습니다. res 폴더 안으로 www 폴더가 있고 그 안에 프로젝트 생성과정에서 선택한 템플릿 화면을 구성하는 HTML 구성요소들이 폴더로 구분되어 들어가 있습니다. 그 밑으로 앱 설정정보를 담고있는 Manifest.xml 파일과 라이선스 정보가 있는 mcore.mobile.lic 파일이 있습니다. 앱 화면 구성을 위해 대부분의 작업을 이 폴더 내부에서 하게 될 것 입니다.
¶ 3) iOS
iOS 앱을 위한 프로젝트 파일이 위치해 있습니다.
-
ios/project/build : 앱을 빌드할 때 결과(library, native source, ipa 등)가 생성되는 위치입니다.
-
ios/project/Classes : object-c 또는 swift 등의 파일이 포함되는 경로입니다.
-
ios/project/Supporting Files : 템플릿 프로젝트에서 iOS 이미지등 기타 파일들이 위치하는 경로입니다.
¶ 4) node_modules
@morpheus 폴더에서 프로젝트에 적용된 M라이브러리들을 확인 할 수 있습니다.
¶ 5) 기타 파일
프로젝트 설정 정보, Gradle 버전정보 등을 담고있습니다.