============================================================
IDE 와 Android Studio 같이 사용하기
============================================================

이 문서는 IDE를 통해, 생성된 프로젝트를 Android Studio 에 Import 하여, Android Studio 기능을 같이 활용 할 수 있는 방법에 대한 가이드 입니다.


.. toctree::
	:maxdepth: 4
	

.. note::
 	아래 링크를 통해, 변환 절차를 동영상으로 확인 할 수 있습니다.
 	
	`동영상 보기 <https://youtu.be/pTu9va0O9J4>`_

변경 순서
=============
1. IDE를 통한 Gradle 프로젝트로 변경 
2. Android Studio 를 통한 프로젝트 import



Gradle 프로젝트 변경
==================================
	
	.. figure:: ../../../_static/ide/client/etc/gradle-1.png
	
	Gradle 빌드로 변환하려는 프로젝트에 마우스 우 클릭 후 Configure -> Convert Gradle Morpheus Configuration을 선택합니다.
	
	
	.. figure:: ../../../_static/ide/client/etc/gradle-2.png
	
	Gradle Configuration 항목을 설정합니다.
	(Build 그룹의 설정 항목들은 Android SDK를 통해 미리 설치 되어있어야 .)
	   - SDK Version : Android Build에 사용할 SDK 버전을 선택합니다.
	   - Build Tools Version : Build Tools 버전을 선택합니다.
	
	Signing 항목을 설정합니다.
	(필수 설정 항목이 아니며 추후 APK Export를 할때 설정해도 무관)
	   - Keystore Location : Keystore 경로를 입력합니다.
	   - Keystore Password : Keystore 비밀번호를 입력합니다.
	   - Alias : Keystore에서 설정한 Alias를 선택합니다.
	   - Alias Password : Alias 비밀번호를 입력합니다.
	
	모든 설정 완료 후 Finish 버튼을 누르면 Gradle 빌드를 위한 파일들이 생성됩니다.


주의 사항
==================================

	.. figure:: ../../../_static/ide/client/etc/gradle-3.png
	
	프로젝트 변환 후 기존의 libs 폴더는 mcoreLibs폴더로 변경되며 기존의 libs 폴더는 Gradle 시스템이 사용하게 되므로 jar 라이브러리 추가 및 제거는 mcoreLibs 폴더를 이용하셔야 합니다.


Import Android Studio 
===================================
	AndroidStudio 를 통해, 프로젝트를 Import 하여, AndroidStudio 기능을 이용할 수 있습니다.

	.. warning::
	  	IDE를 통해, Gradle 환경으로 변경 된 경우에만 정상적으로 적용이 됩니다.



	1. Open an existing Android Studio project 를 선택 

		.. figure:: ../../../_static/ide/client/etc/importstudio-0.png

	2. import 하고자 하는 프로젝트 폴더를 선택 

		.. figure:: ../../../_static/ide/client/etc/importstudio-1.png

	3. Android SDK Manager 선택 Wizard

		.. figure:: ../../../_static/ide/client/etc/importstudio-2.png

	4. Android Studio 용 SDK를 사용 하도록 선택 

		.. figure:: ../../../_static/ide/client/etc/importstudio-3.png

	5. Gradle Version 업그레이드 여부를 선택함. 필요시 업데이트 

		.. warning::
		  	업데이트 하는 경우, IDE Gradle GUI는 사용할 수 없음 (gradle 4.0 이상부터는 gradle gui 가 지원되지 않음)
	  

		.. figure:: ../../../_static/ide/client/etc/importstudio-4.png

	6. 업데이트 선택 

		.. figure:: ../../../_static/ide/client/etc/importstudio-5.png

	7. gradle 변환 작업이 진행되며, 경우에 따라서는 Error 상황을 처리 해야 합니다.


앱 실행 [IDE 이용시]
================================== 

 Application Manifest Editor를 이용하는 방법과 도구 상단 Run 버튼을 이용하는 방법이 있습니다. 
 Gradle 빌드를 이용한 앱 실행은 단말기를 선택하는 UI를 제공하지 않습니다. 단말기가 연결되어 있는 상태에서 실행하기를 진행하기 바랍니다.

	* Application Manifest Editor를 열고 실행 / 배포 그룹에서 안드로이드 디바이스/에뮬레이터에서 애플리케이션 실행하기를 선택하시기 바랍니다.
		
		.. figure:: ../../../_static/ide/client/3/3-17.png
			
	* Project Explorer에서 실행하려는 프로젝트를 선택하고 도구 상단 Run 메뉴 옆에 세모 버튼을 누르면 그럼 아래 그림과 같이 드롭다운 메뉴가 나타납니다.
		
		.. figure:: ../../../_static/ide/client/3/3-18.png
			
	Run As메뉴에서 Application for Android 선택합니다.
	
	
	.. figure:: ../../../_static/ide/client/etc/gradle-4.png

	빌드 및 실행 로그가 Console를 통해 출력됩니다.
	

APK 배포 [IDE 이용시]
================================== 

Application Manifest Editor를 이용하는 방법과 Export 메뉴를 이용하는 방법이 있습니다. 

	* Application Manifest Editor를 열고 배포하기 그룹에서 안드로이드 패키지로(APK) 배포하기 선택합니다.
		
		.. figure:: ../../../_static/ide/client/3/3-24.png
	
			
	* 상단 메뉴 중 File → Export를 선택하면 Export 대화상자가 나타납니다. Morpheus 트리를 열고 Export Morpheus Application for Android를 선택합니다.
		
		.. figure:: ../../../_static/ide/client/3/3-25.png
	
	이후의 설정 과정은 기존 과정과 동일하며 APK 배포 내역이 Console를 통해 출력됩니다.