Howdy, Stranger!

It looks like you're new here. If you want to get involved, click one of these buttons!

CodeaProjectBuilder - A Codea build machine

edited October 2013 in General Posts: 67

Hey Codea users!

If you're like me and want to be able to do all your game development on your iPad, including the integration of mp3 music or GameCenter add-ons, and never have to go to your computer, CodeaProjectBuilder is for you!

Recently, I started thinking about using Jenkins (an "open-source continuous integration server") and realized I had all the tools required to setup a Codea build machine on my mac.

Everything used is completely free. I tried to get the installation instructions as clear as possible so that everyone can install and use this build machine.

You can download CodeaProjectBuilder and follow the installation instructions on my GitHub at

Let me know if you face any problems with the installation so I can improve the instructions, and tell me what you think!

I plan on creating new compatible add-ons like GameCenter very soon.

Enjoy :)

Here's a YouTube video showing what you can do once you have CodeaProjectBuilder up-and-running :


  • BriarfoxBriarfox Mod
    Posts: 1,542

    Very cool, Can't wait to play with this.

  • edited October 2013 Posts: 2,054

    @jfperusse, looks nice. I am unsure how to get the absolute path to my Dropbox folder. How do I find the /users/-----/ url?

    EDIT: just realized it meant on my computer. got it working

  • Posts: 152

    Very,very cool, this sounds really powerful to fully feature Codea apps, will give it a try

  • Posts: 2,820

    Very cool. Nice job!

  • @JakAttak, glad you got it working! I'm working hard improving the build machine and add-ons, let me know if you have any issue or suggestion!

  • Posts: 2,054

    The only suggestion I have is make more add-ons :) This is invaluable for those of us who want to do everything on our iPad

  • BriarfoxBriarfox Mod
    Posts: 1,542

    I hate turning on the mac more then anything. With this, I just leave it running in a corner of the office :

  • @JakAttak, of course! I will soon be adding more functions to the GameCenterAddon so that we can actually unlock achievements and send scores to the leaderboards. I plan on converting the iAd add-on, exposing more AVAudioPlayer functions, etc. Any specific add-on you have in mind which should be added in priority?

    @Briarfox, exactly! Having the possibility of leaving a mac turned on and taking care of the builds automatically makes the development of Codea apps even more enjoyable and saves time for more creativity ;)

  • Posts: 2,054

    The top ones I think would be GameCenter, iAD, and iAP

  • Posts: 577

    @JakAttak Ah! So many messages!

  • @JakAttack I think I get it ;) I'll add iAP to my list :)

  • Posts: 355

    @jakattack u have problems whit your connection ??

  • Posts: 2,054

    Oh my. Sorry guys, 5 posts... @Simeon I think the forum bug is back.

  • Posts: 355

    yes, today i have the same problem , but now is good @jakAttack

  • Posts: 2,161

    (I did a bit of housekeeping @JakAttak)

  • Alright, full-featured MusicAddon is now ready. You can do everything you would be able to do with the AVAudioPlayer.

    You can get the files here :

    New documentation here :


  • Jmv38Jmv38 Mod
    Posts: 3,297

    @jfperusse i just discover your work now. This is amazing stuff! Anything new since october?

  • Posts: 1,595

    @jfperusse This is awesome. Good contribution for someone so new!

  • Posts: 67

    Hi and thanks! Nothing new yet :( Been spending a lot of time with our baby :)

    Since Codea 2.0 is coming really soon, I think it's best to wait after its release to see if the build machine still works. I know the MusicAddon might not be necessary anymore.

  • Posts: 152

    Hiya, I use this continuously so I can deploy my game to my colleague who is writing the AI portion of the game, it works really well, although I do find I have to a) delete the zip file after the build as my dropbox will not overwrite the zip for some reason, and I do have to restart Jenkins periodically as the certificate signing fails over time, which is weird, but a restart sorts it out...

    It is brilliant, would love an addon for sockets and also for an embedded webserver for player versus player e.g. cocoahttpserver...


  • Posts: 67

    Hi brookesi! Glad to hear this is being used :)

    For a), you're saying that Codea does not overwrite your project when you export it again to Dropbox? I know for sure I didn't have to delete the zip file when I created this solution. However, I would have to test again to check if this is something caused by a newer version of Dropbox :/

  • BriarfoxBriarfox Mod
    Posts: 1,542

    @jfperussee Thanks again for this project. Very handy.

  • BriarfoxBriarfox Mod
    Posts: 1,542

    I'm trying to set this up on a different mac and I cant remember how to add the Testflight token. I don't seem to have the option in global certs.

  • Posts: 67

    @Briarfox I just happen to be installing it again on a different mac as well. I know some stuff changed in TestFlight in the latest versions. The first step is to go under Manage Jenkins, Configure System, and add your keys to the Test Flight section. Then you can use those keys in your CodeaProjectBuilder project.

  • edited July 2014 Posts: 67

    I updated CodeaProjectBuilder to better support multiple projects (if only I would ship at least one Codea game, I would have covered these issues already ;) ).

    I confirm that the build machine still works fine with Codea 2.0, and, obviously, the MusicAddon is not necessary anymore.

  • The user and all related content has been deleted.
  • BriarfoxBriarfox Mod
    Posts: 1,542

    @NatThecoder you can make fully fledged games with Codea. I'm not sure I understand your question. You can use jenkins to build your codea project.

  • edited July 2014 Posts: 1,595

    @NatTheCoder this helps a lot if you don't know much obj-c, as it is a bit like plug and play addons that build with the original Codea code

  • The user and all related content has been deleted.
  • edited July 2014 Posts: 67

    @NatTheCoder, as @Briarfox mentionned, you can make fully fledged games with Codea.

    However, when you want to share your game around (e.g. for testing purposes), test it on different devices like iPhones, or if you want to access features that are not part of Codea (e.g. GameCenter), you have to:

    1) Export your project

    2) Send it to a Mac computer (e.g. DropBox)

    3) Unarchive the project

    4) Open it in Xcode and configure the project (bundle identifier, mobile provision, screenshots, resources, etc.)

    5) Add extra code like plugins

    6) Compile the project

    7) Archive it

    8) Send it to your friends (e.g. TestFlight)

    What the CodeaProjectBuilder does is take care of steps 3-8 for you, so it does actually a lot more than what @Luatee said!

    You simply have to export your project and put it in DropBox, then sit back and relax while the build machine does all the work for you. In the entire process, you never have to plug your device to your PC, or use your mac computer. In the end, you and your friends get an e-mail to say the game is ready to download on the devices using TestFlight.

    Obviously, in order to set this up, you must already be familiar (and set up) with how to build Codea exported Xcode projects.

    Hope that answers your question!

  • The user and all related content has been deleted.
Sign In or Register to comment.