2014년 3월 6일 목요일

Cocos2d-x Eclipse에서 C++ 환경설정


1. Eclipse CDT Plugin 설치
Eclipse CDT(C/C++ Development Tooling)는 이클립스 상에서 C, C++ 빌드 환경을 제공하여, C, C++로 만든 소스를 쉽게 빌드하여 사용할 수 있게 프로젝트를 만들거나 C, C++ 소스를 추가할 수도 있다.

2. Convert to a C/C++ Project
ㄱ. 우클릭 > New > Other 선택
ㄴ. C/C++ > Convert to a C/C++ Project(Adds C/C++ Nature) 선택
ㄷ. 프로젝트 선택하고 Project Type을 Makefile project 로 선택 하고 Finish
[ 우클릭 > New > Other 선택 ]

[ C/C++ > Convert to a C/C++ Project(Adds C/C++ Nature) 선택 ]

[ 프로젝트 선택하고 Project Type을 Makefile project 로 선택 ]


3. Source Location 설정
ㄱ. 프로젝트의 Classes 아래 소스 링크 추가
Project 우클릭 > Properties > C/C++ General > Paths and Symbols > Source Location 탭 선택
> Link Folder... 클릭 > Link to folder in the file system 체크 > Browse... 선택 > 프로젝트 Root경로 밑의 Classes 폴더 선택 
Tip > Folder name이 Classess 가 있다고 나오면 폴더명을 수정해 준다.(아래 그림 Classess_CPP 로 지정)

[ Source Location 설정 ]

[C++ 소스 확인]
ㄷ. Cocos2d-x 소스 링크 추가
Project 우클릭 > Properties > C/C++ General > Paths and Symbols > Source Location 탭 선택
> Link Folder... 클릭 > Link to folder in the file system 체크 > Browse... 선택 > Cocos2d-x의 Root  폴더 아래 cocos 폴더 선택 



[ Cocos2d-x 소스 링크 추가 ]

4. C++  환경 설정
ㄱ. Code Analysis 설정
 Project 우클릭 > Properties > C/C++ General > Code Analysis 선택
Syntax and Semantic Errors 선택 되어 잇는 부분을 해지 한다.

[ Code Analysis 설정 ]

ㄴ. NDK Includes 추가
 Project 우클릭 > Properties > C/C++ General > Paths and Symbols >  Add 선택
${NDK_ROOT}/platforms/android-19/arch-arm/usr/include 추가

[ Android NDK Includes 추가 ]

ㄷ. C++ Builer를 build_native.py로 변경
해 주어야 할거 같은데...
어디서 하는지 못 찾겠다 ㅋㅋㅋ



오늘도 여기까지만... 이제 소스 보는거랑 컴파일이랑 실행이랑 다 된다.
앞으로는 build_native.py,  Android.mk 등을 어떻게 수정 해야 할지 보면 될거 같다.

아 여기까지 하기 위해 프로젝트 생성만 얼마나 했던가...
이제 코딩 공부 Start ^^ 





2014년 3월 5일 수요일

Cocos2d-x 프로젝트 생성부터 Eclipse에서 빌드, 실행까지

1. Cocos2d-x 프로젝트 생성

cocos2d-x-3.0beta2 설치디렉토리\tools\project-creator\create_project.py 실행


- Project Name : 프로젝트 명 입력
- Package Name : 패키지 명
- Project Path : 프로젝트 Workspace 경로
- Language : C++

create_project.py -p PuzzleGame -k kr.co.hanguk.cocos2d.puzzlegame -l cpp

create 버튼을 클릭하면 다음과 같이 프로젝트 경로에 파일이 생성된다.


2. Eclipse 프로젝트 Import
2.0. Eclipse 환경 변수 설정
  ㄱ. Path Variable `COCOS2DX`: 
    * Eclipse->Preferences->General->Workspace->**Linked Resources**
Name : COCOS2DX
        Location : cocos2d-x의 Root directory.



  ㄴ. C/C++ Environment Variable `NDK_ROOT`: 
     * Eclipse->Preferences->C/C++->Build->**Environment**.
       Name : NDK_ROOT
       Value : Android NDK Root directory 경로



2.1. libcocos2dx 프로젝트 Import
Cocos2d-x는 libcocos2dx 라는 라이브러리를 사용해야만 한다.
그러기 위해 라이브러리 프로젝트를 Import 시켜두어야 한다.
- File > import 선택
[ Exisition Android Code Info Workspace 선택 ]


%cocos2d-x-3.0beta2 설치경로%\cocos\2d\platform\android

새로 생성된 프로젝트에서 Project > Properties > Android 를 열어 보면 Library 부분이 링크가 깨져 있는것을 볼수 있다. 이것을 해결 하기 위해 미리 libcocos2dx Library 프로젝트를 Import 해 둘 필요가 있다.



2.2. 신규 생성한 프로젝트 Import
- File > import 선택
위에서 생성한 프로젝트 안의 폴더 중에 proj.android 를 선택 한면 된다.

[ Exisition Android Code Info Workspace 선택 ]

[ Root Directory : proj.android선택 ]

[ Projects 에 PuzzieGame 확인 하고  Finish 클릭 ]

※참고 : libcocos2dx 프로젝트 Import
새로 생성된 프로젝트에서 Project > Properties > Android 를 열어 보면 Library 부분이 링크가 깨져 있는것을 볼수 있다. 이것을 해결 하기 위해 미리 libcocos2dx Library 프로젝트를 Import 해 둘 필요가 있다.
%cocos2d-x-3.0beta2 설치경로%\cocos\2d\platform\android\java
를 Improt 시키면된다.


3. 프로젝트 NDK Build 하기

모른척 하고 build_native.py 실행(더블클릭)하면 libs\armeabi\libcocos2dcpp.so 파일이 생성된다. 그럼 끝~~!!

(※참고 : build_native.py -n clean)





4. 프로젝트 환경설정 파일 변경
이제 libcocos2dcpp.so를 Java와 연결하고 빌드하여 APK 파일을 생성하면 된다. 
그 전에 설정 좀 바꿔줘야 할 것이 있다.

## AndroidManifest 파일 편집
    <uses-sdk android:minSdkVersion="9"/>
==>
    <uses-sdk 
        android:minSdkVersion="10"
        android:targetSdkVersion="19"
        />
실행 가능한 최소 버전은 10(2.3.3) 컴파일 타겟 버전은 14(4.0)로 설정했다.


        <activity android:name="org.cocos2dx.cpp.Cocos2dxActivity"
                  android:label="@string/app_name"
                  android:screenOrientation="landscape"
                  android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
                  android:configChanges="orientation">
==>
        <activity android:name="org.cocos2dx.cpp.Cocos2dxActivity"
                  android:label="@string/app_name"
                  android:screenOrientation="landscape"
                  android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
                  android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize">

안드로이드 폰의 가로세로모드 변경 또는 키보드 창 등과 같은 화면변화가 일어나면 기본적으로 액티비티가 재생성되는데 configChanges에 명시 하면 명시된 변경 사항이 발생하면 Activity에서 직접 처리하겠다는 의미

keyboard|keyboardHidden 키보드 입력에 관련(cocos2d-x는 extension에서 키보드입력 지원)
uiMode|screenSize|smallestScreenSize  전원 버튼이 눌리어서 Lock 되었을때 발생
orientation 화면이 가로 세로로 변경


## project.properties 파일 편집
빌드 타켓이 위에서 설정한 19로 되어 있는지 확인하고 안되어 있으면 19로 변경
target=android-19

※참고
Run As > Android Application 했을때 다음과 같은 에러가 나오는 경우가 있다.
[2014-03-05 16:40:53 - Dex Loader] Unable to execute dex: java.nio.BufferOverflowException. Check the Eclipse log for stack trace.
[2014-03-05 16:40:53 - MyGame] Conversion to Dalvik format failed: Unable to execute dex: java.nio.BufferOverflowException. Check the Eclipse log for stack trace.

이 경우 일단 Add SupportLibrary를 해 주고......
ㄱ. Add SupportLibrary
Project 우클릭 -> Android Tools -> Add Support Library
그리고 Accept License 를 클릭해서 인스톨 해 주면된다.
ㄴ. Android Target 버전을 14로 했다면 19로 바꿔 주도록 한다.
ㄷ. 라이브러리 libcocos2dx 의 Android Target 버전도 19로 되어 있는지 확인해서 안되어 있다면 19로 변경해 준다.


5. 실행
Project > Run As > Android Application.

갤럭시S2에서 실행된 모습 ^^v


일단 오늘은 여기 까지... ^^


※ 급 추가
jni > hellocpp > main.cpp 를 열었을때 에러가 표시될때가 있다(에러가 나면 Run을 할 수가 없게 된다. ㅠ,.ㅠ 궁금해서 main.cpp를 열어 봣는데... 괜히 열었어 라는 생각이 든다. 하지만 언제가 열어 봐야 할거 같은 느낌은 뭘까....). 이 경우 C/C++ General 의 Code Analysis 를 열어 Use workspace settings 에 체크됭어 잇으면 Use project settings으로 변경해 주면 에러가 사라진다.(일단 다시 실행 할수 있게는 되었다. 하지만... 이놈은 뭐하는 놈일까.. 싶다.)





Cocos2d-x 디렉토리 구조


1. Cocos2d-x Architecture

2. Cocos2d-x Directory Structure

Directory
Explain
build
This folder includes top level xcode projects, visual studio solutions and makefiles
cocos
This is the major directory for cocos2d-x framework.
docs
You can download doxygen, use it to open doxygen.config file in this this folder, then generate offline API docs by yourself
extensions
This folder is almost deprecated after v3.0. Please use cocos/gui instead of extensions/GUI, use cocos/physics instead of extension/physics-nodes. Assets-manager can work but will be refactor sooner
external
Here are all 3rd libraries which is dependencied by cocos2d-x
licenses
Cocos2d depends on many other open source projects. All of their licenses are here. We've avoid all GPL/LGPL libraires, so cocos2d-x and its dependencies are commercial friendly.
samples
IMPORTANT. This is where you should start from. Cpp/HelloCpp can be your first lesson, and you can find the usages of all classes in TestCpp. Looking for lua and js samples? They’re also here.
template
Here're templates for creating cocos2d-x new project in different IDEs and various platforms.
tools
Lots of different command line tools, such as createing new projects, binding c++ to lua to javasript, compile javascript into bytecode, etc. We're refactoring this into cocos-console.


2014년 3월 4일 화요일

Eclipse + Cocos2d-x 를 이용한 안드로이드 게임 개발 환경

현재 버전 Cocos2d-x 3.0beta를 기준으로 함.

1. Java SE 설치


2. Python 설치
cocos2d 프로젝트 생성 및 빌드시 필요
http://www.python.org/download/

※ Android 빌드 스크립트
이전 버전까지는 윈도우에서 Android용으로 빌드하기 위해서는 cygwin을 설치해야 했었다고 한다. 설치도 번거롭고 사소한 문제들 때문에 빌드가 안되는 경우가 많아 다소 불편했었다고 하는데.....

이번에 build_native.py라는 파이썬 스크립트가 포함되어 이제 윈도우에서도 cygwin 없이 python만 설치되어 있으면 Android용으로 간편하게 빌드할 수 있다.


3. cygwin 설치(옵션)
c++로 코딩한 것을 자바에서 사용 가능한 라이브러리로 컴파일하기 위해 Cygwin을 설치
http://cygwin.com/install.html
(Cocos2d-x 3.0 이하버전에서 컴파일을 위해 사용되어 짐. )

4. Ant 설치
http://ant.apache.org/bindownload.cgi

C:\Program Files\Apache Software Foundation\apache-ant-x.x.x 압축풀기
환경변수
ANT_HOME : C:\Program Files\Apache Software Foundation\apache-ant-1.9.4
path 추가 : ;%ANT_HOME%\bin

명령어(cmd) 창에서 확인
ant -version 실행

5. cocos2d-x-3.0beta2 설치
http://www.cocos2d-x.org/download

6. Android SDK 설치
http://developer.android.com/sdk/index.html

7. Android NDK 설치
안드로이드는 달빅가상머신(dalvik virtual machine, DVM)상에서 JAVA 코드를 돌립니다. NDK는 C/C++같은 네이티브 코드 언어를 이 가상머신에서 사용할 수 있도록 해주는 툴셋입니다. cocos2d-x는 C++로 개발하므로 NDK가 필수로 필요합니다.

다운로드 후 적당한 위치에 압축을 풀어준다.

http://developer.android.com/tools/sdk/ndk/index.html


8. Eclipse 설치

9. Eclipse CDT
Eclipse CDT(C/C++ Development Tooling)는 이클립스 상에서 C, C++ 빌드 환경을 제공하여, C, C++로 만든 소스를 쉽게 빌드하여 사용할 수 있게 프로젝트를 만들거나 C, C++ 소스를 추가할 수도 있다.

10. Eclipse Android PlugIn
https://dl-ssl.google.com/android/eclipse/


※ 시스템 환경 변수 설정
JAVA_HOME : C:\Program Files\Java\jdk1.7.0_51

ANDROID_HOME : D:\Dev\Android\sdk

CLASS_PATH :  ;C:\Python27

NDK_MODULE_PATH : D:\Dev\cocos2d-x\cocos2d-x-3.0beta2;D:\Dev\cocos2d-x\cocos2d-x-3.0beta2\cocos\2d\platform\android

NDK_ROOT : D:\Dev\Android\android-ndk-r9c

Path : 추가 


일단 여기까지.... ^^



2014년 2월 27일 목요일

Eclipse에 Maven(m2eclipse) 플러그인 설치 및 프로젝트 생성

1. m2eclipse 플러그인 설치

m2eclipse 플러그인을 사용하려면 먼저 이클립스의 Help >> Install New Software… 이동하여 m2eclipse 플러그인을 설치한다. m2eclipse 플러그인의 update url 은 http://m2eclipse.sonatype.org/sites/m2e 이다.

[ m2eclipse 플러그인을 설치하는 화면 ]


2. 프로젝트 생성
m2eclipse 플러그인을 설치하면 이클립스에서 메이븐 프로젝트를 생성하는 것이 가능하다. File >> New >> Project로 이동한 후 Maven 메뉴로 이동한 후 “Maven Project”를 선택한다.

[ 메이븐 프로젝트를 생성하는 화면 ]

위의 그림을 보면 버전 관리 시스템에 존재하는 프로젝트를 메이븐 프로젝트로 체크아웃하는 기능(Checkout Maven Projects from SCM)부터 여러 개의 모듈을 관리할 수 있는 기능(Maven Module)까지 제공하고 있다. 여기에서는 프로젝트를 생성하기 위하여 “Maven Project” 메뉴를 선택하고 “Next” 버튼을 선택한다.


[ 프로젝트 생성 경로를 선택하는 화면 ]

위의 화면에서의 기본 설정은 “Create a simple project(skip archetype selection)”이 체크되어 있지 않은 상태이다.

기본 설정으로 다음 단계로 넘어가면 아키타입의 대화식 모드를 이용하여 프로젝트를 생성하는 과정이 나온다. 메이븐에서 기본으로 제공하는 아키타입을 이용하여 프로젝트를 생성할 경우 불필요한 소스 코드를 제거하고 JUnit 의존 관계 설정을 제거해야 한다. 특히 maven-archetype-webapp 아키타입의 경우 소스 폴더가 자동으로 생성되지 않아 추가적으로 생성해야 하는 불편함이 있다.

이 같은 불편함을 없애고 단순히 메이븐 기본 디렉토리를 포함하는 프로젝트를 생성하고 싶다면 위의 그림과 같이 “Create a simple project(skip archetype selection)”를 체크한 후 “Next” 버튼을 누르고 프로젝트와 관련한 정보를 입력한다.


[ 위키북 프로젝트에 대한 기본 정보를 입력하는 화면 ]

위의 그림에서 보는 바와 같이 위키북 프로젝트에서 사용할 Group Id, Artifact Id, Version, Packaging을 입력하고 Finish 버튼을 눌러 프로젝트를 생성한다.

[ m2eclipse 플러그인을 활용하여 생성한 위키북 프로젝트 ]
m2eclipse 플러그인을 기반으로 프로젝트를 생성할 경우 위의 그림에서 보는 바와 같이 기본 디렉토리를 가지는 템플릿 프로젝트가 생성된다. 위키북 프로젝트의 pom.xml 파일을 열어보면 위에서 입력한 정보를 제외하고는 아무런 설정 정보도 추가되어 있지 않다.
<project ...>
  <modelVersion>4.0.0</modelVersion>
  <groupId>net.javajigi</groupId>
  <artifactId>wikibook</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>
  <name>wikibook</name>
</project>


3. m2eclipse 플러그인 저장소 설정
m2eclipse 플러그인을 설치하면 위의 그림에서 볼 수 있듯이 pom.xml 파일과 프로젝트의 좌측 상단에 푸른색으로 “M”자가 표시된다. 이는 m2eclipse 플러그인이 메이븐 기본 설정 파일을 인식한다는 뜻이다.

m2eclipse 플러그인을 설치하면 M2_REPO Classpath Variables를 자동으로 추가한다. m2eclipse 플러그인을 설치한 후 Window >> Perferences >> Java >> Build Path >> Classpath Variable메뉴로 이동해 보면 그림 6-18과 같이 M2_REPO가 “non modifiable”로 추가되어 있는 것을 알 수 있다.

[ m2eclipse 플러그인을 설치한 후의 M2_REPO 설정 ]

M2_REPO 변수를 m2eclipse 플러그인이 관리하고 있기 때문에 수정할 수 없는 상태로 관리된다. 위의 그림에서 확인할 수 있듯이 M2_REPO 값은 기본 로컬 저장소인 USER_HOME/.m2/repository 값으로 설정된다. 만약 로컬 저장소를 변경해서 사용하고 있다면 다음과 같이 로컬 저장소를 변경해야 한다.

먼저 테스트를 위하여 USER_HOME/.m2/settings.xml 파일의 로컬 저장소 설정을 다음과 같이 “D:\m2\repository” 디렉토리로 설정한다.

# 로컬 저장소를 D:\m2\repository 디렉토리로 설정하는 settings.xml 파일
<settings ...>
<localRepository>D:\m2\repository</localRepository>
[...]
</settings>

기본 로컬 저장소를 사용하지 않으면 먼저 Window >> Perferences >> Maven >> User Settings 메뉴로 이동한 후 Update Settings 버튼을 클릭한다.

[ m2eclipse 플러그인에서 로컬 저장소의 경로를 변경하는 화면 ]

Update Settings 버튼을 클릭하면 Local Repository의 값이 위의 그림과 같이 “D:\m2\repository”로 변경된다. Update Settings 버튼을 클릭할 경우 Local Repository의 값이 바로 반영되지 않는 경우가 있다. 이 때는 다른 메뉴에 접근한 후 다시 User Settings 메뉴로 이동해보면 settings.xml 파일에 설정한 로컬 저장소로 반영되어 있는 것을 확인할 수 있다.

로컬 저장소의 경로를 변경할 경우 Window >> Perferences >> Java >> Build Path >> Classpath Variable 메뉴에 설정되어 있는 M2_REPO도 변경해야 한다. M2_REPO의 값을 새로 설정한 로컬 저장소로 변경하려면 앞의 과정을 통하여 로컬 저장소를 변경한 후 이클립스를 재시작해야 하면 자동으로 반영된다.


4. m2eclipse를 활용한 메이븐 실행

m2eclipse를 설치한 다음 pom.xml 파일에서 오른쪽 클릭 >> Run As로 이동하면 메이븐에서 자주 사용하는 페이즈와 골을 실행할 수 있다. m2eclipse를 활용하여 메이븐 명령을 실행하려면 먼저 USER_HOME\.m2 디렉토리에 settings.xml 파일을 생성해야 한다. 루트 엘리먼트(<settings/>)를 가지는 settings.xml 파일을 생성하거나 MAVEN_HOME\conf 디렉토리의 settings.xml 파일을 복사한다.

[ m2eclipse에서 실행 가능한 페이즈와 Goal ]
위의 그림을 보면 clean, install, package등 자주 사용하는 메이븐 페이즈를 실행할 수 있도록 지원하고 있다. 만약 Run As 메뉴에서 기본으로 제공하지 않는 페이즈나 골을 실행하려면 위의 그림에서 “Maven build...”을 실행한다. “Maven build...”을 실행하면 명령 프롬프트에서 메이븐을 실행할 때와 똑같이 특정 플러그인의 골을 직접 입력해 실행할 수 있다.

[ m2eclipse로 메이븐을 빌드하는 화면 ]

이 기능을 활용하면 명령 프롬프트에서 빌드할 필요없이 이클립스에서 메이븐을 빌드할 수 있다. 이클립스에서 명령 프롬프트로 이동하지 않아도 되므로 유용하다.

메이븐을 빌드할 때마다 이전에 빌드했던 “eclipse:clean eclipse:eclipse”를 입력하는 것도 귀찮은 작업이 된다. 이클립스는 이전에 실행한 모든 명령들에 대한 이력을 관리한다. m2eclipse에서 실행한 결과는 Run >> Run History메뉴나 이클립스 상단의 단축 아이콘으로 접근할 수 있다.

[ 이전 m2eclipse 빌드 이력을 보는 화면 ]

<참고사항>
내가 m2eclipse를 즐겨 사용할 때는 메이븐 기반 프로젝트를 빌드하기 위하여 자주 사용하는 명령어를 등록해 사용했다. 예를 들어 다음과 같이 명령어를 등록해 사용할 수 있다.
 wikibook for eclipse(이클립스 기반 프로젝트로 전환) : eclipse:clean eclipse:eclipse
 wikibook for build(프로젝트 빌드) : clean test

프로젝트의 빌드 상태에 따라서는 특정 Goal을 실행해야 하는 상황이 발생할 수 있기 때문에 자주 사용하는 페이즈와 골 조합을 위와 같이 등록해 사용하면 유용하다.
</참고사항>


5. m2eclipse를 활용한 설정 파일 및 의존 관계 관리

m2eclipse 플러그인을 활용할 때 유용하게 사용할 수 있는 기능이 지금까지 명령 프롬프트상에서 명령을 실행하고 결과물을 확인했던 내용을 이클립스에서 명령어를 몰라도 좀 더 좋은 UI를 통해 확인할 수 있다는 것이다.

메이븐 기반 프로젝트에서 pom.xml 파일을 더블 클릭하면 pom.xml 파일의 소스 코드가 바로 나타나지 않고 Overview 화면이 기본으로 열리며, 여러 개의 탭 화면을 가지는 것을 확인할 수 있다. 이 각각의 탭 중에서 유용하게 사용할 수 있는 몇 가지 기능에 대하여 살펴보도록 하겠다.

첫째, Dependencies 탭은 해당 프로젝트와 의존 관계에 있는 라이브러리를 관리할 수 있도록 지원한다. 5장에서 http://mvnrepository.com/ 사이트에 접속해 라이브러리를 검색하고 추가하던 작업을 m2eclipse를 활용해 가능하다.

[ Dependencies 탭에서 spring-core 라이브러리를 추가하는 화면 ]