This documentation will show you how to use cocos console to create and run a new project.
Runtime Requirements
- Android 2.3+
- iOS 5.0+
- OS X 10.7+
- Windows 7+
- Ubuntu 12.04+
- Cocos2d-x v3.0+
Software Requirements
- Xcode 4.6 (for iOS or Mac)
- gcc 4.7 for Linux or Android. For Android ndk-r9 or newer is required.
- Visual Studio 2012 (for Windows)
- Python 2.7.5
Create A New Project
$ cd cocos2d-x $ ./setup.py $ source ~/.bash_profile # may be ~/.bash_login or ~/.profile, depends on your environemnt $ cocos new MyGame -p com.MyCompany.MyGame -l cpp -d ~/MyCompany
-
MyGame
: name of your project -
-p com.MyCompany.MyGame
: package name for android -
-l cpp
: programming language used for the project, valid value iscpp
andlua
-
-d ~/MyCompany
: directory to hold your project
Folder structure of the generated project is as following:
(Note: The directory may be different when the project type is lua.)
Build And Run New Project
$ cocos run -s ~/MyCompany/MyGame -p ios
-
-s
: directory of the new project. This could be an absolute path or a relative path. -
-p
: which platform to run on. Options areios
,android
,win32
,mac
andlinux
.
(Note: You are a tmux user, you should add reattach-to-user-namespace
before the command cocos
. For more information, please refer to this link for more information.)
You can run cocos run --help
for more detail information.