Download Cocos2d-x

We shall be using the Cocos2d-x C++ game framework to make Doodler.

Go to the Cocos2d-x downloads page and click the link for the latest version (3.6 at the time of this writing) of the Cocos2d-x source code:


Make sure you don't accidentally download Coco2d-JS, Code IDE or Cocos. We're going to be using this copy of the source code as the base for the project.

Once you have downloaded it, move it to wherever you'd like your project to be saved in your filesystem. Then unzip it. Once you have unzipped it, you can delete the .zip file.

Create a New Project

We're going to use the Cocos2d Console tool to generate a new project.

Cocos2d Console is super great, because it will generate an Xcode-based iOS and Mac project, an Eclipse-based Android project and a Visual Studio-based Windows and Windows Phone project all with one command.

In our case we're just going to be using the Xcode project.

In the unzipped folder, navigate to tools/cocos2d-console/bin.

In there you will see an executable named cocos. This is the Cocos2d Console command line tool.

We will use Terminal to run the Cocos2d Console.

If you're not familiar with Terminal, it's OSX's built in shell. The default language used to interface with terminal is called (Bash)[].

You can start a new Terminal by first opening Spotlight either with the magnifying glass button in the top-right of the system menu, or with the keyboard shortcut Command-Space (⌘+Space)

Spotlight button in system menu

Once there, type in terminal and hit enter.

Spotlight terminal search

Your new terminal window should look something like this:

Blank terminal window

We're going to navigate to the Cocos2d Console tool in Terminal so we can run it.

In the terminal first, type cd. Then a space. Now click and drag the bin directory that we navigated to earlier over into the terminal. You should see a long path, something like this:

Terminal showing a path

Hit enter.

Now our terminal is in that directory. By the way, cd stands for change directory, it's the usual way to navigate the filesystem in Terminal.

To see what is in the active directory, type ls and hit enter. ls stands for list.

Try it now!

You should see something like this:

Terminal showing directory contents

To execute an executable in terminal, you type ./ before its name. Then you can send it space separated parameters.

Type the following:

./cocos new -p com.yourname.Doodler -l cpp -d ../../../.. Doodler

Make sure you replace yourname with your name!

Then hit enter.

A successful project creation looks like this:

Terminal showing successful project creation

This command will create a new Cocos2d-x project. The -p parameter specifies the package name, the -l parameter specifies the language (C++) and the -d parameter specifies the directory. In Bash-land, .. means the parent directory. So when we specified ../../../.. for the directory, that meant four directories up the tree, which will put the project right next to the Cocos2d-x source code directory that we downloaded and unzipped.

At this point it's okay to delete the unzipped folder if you want; the process of making the new project the necessary Cocos2d-x source code was copied into the new project directory.

Navigate up four directories to the newly created Doodler one. From there, navigate to the Xcode project in proj.ios_mac and open it.

Project directory

Make it Portrait

The default Cocos2d-x template creates a landscape game, but we want this one to be portrait. Thankfully it's easy to do in Xcode.

Click the project file at the top of the left panel (it says Doodler).

Xcode project properties

This will open a whole bunch of project properties that can be changed.

Under where it says Deployment Info there's a setting that says Device Orientation.

Uncheck the boxes for Landscape Left and Landscape Right and check Portrait. While you're at it, change the Deployment Target to 8.0.

Xcode changed project properties

The Deployment Target is the minimum version of iOS that we're going to support. Because later we'll want to use latest version of the Multipeer Connectivity framework, we're going to support only devices running iOS 8 and newer.

Run It!

Click the big play button in Xcode's top bar.

After a bit of time spent compiling the over 600 source files in Cocos2d-x, you should see this:

iOS Simulator

Now let's move on to making a drawing canvas!


If you have feedback on this tutorial or find any mistakes, please open issues on the GitHub Repository or comment below.

Summer academy

An iOS Development Summer Course

Design, code and launch your own app. Locations in San Francisco and Asia

Find your location

Product College

A computer science college

Graduate into a successful career as a founder or software engineer.

Learn more

Cookies on Make School's website

We have placed cookies on your device to ensure that we give you the best experience on our website.

This site uses cookies to deliver our services. By using our site, you acknowledge that you have read and understand our Cookie Policy, Privacy Policy, and our Terms of Service. Your use of Make School’s Products and Services is subject to these policies and terms.

Please note that Make School no longer supports Internet Explorer

We recommend upgrading to a modern web browser. Learn more