EDIT (18-Jul-2015): This guide has not been updated since the last post (15-Nov-2013) and probably does not apply to AppGameKit 2 and certainly not to the latest version of XCode.
EDIT (15-Nov-2013): The TGC guide for iOS Tier 1 is now much better and fairly good for Xcode 4. The instructions in this post go into a little more (excrutiating?) detail.
EDIT (4-Nov-2013): This is for Xcode 4. The Xcode 5 interface has been changed. Pretty much all instructions still apply, but you have to find the new place in the interface for them. For instance, instead of two obvious sections for the icons and default images, with the images visible, for iPhone and iPad, there is one section with a list of the icons/images needed with buttons next to each to select or display them and there are two buttons under that list labeled 'iPhone' and 'iPad'. You switch between the two with those buttons.
So, here is my version. It is recently updated to deal with Facebook issues.
If you have any issues with them, please let me know.
===================================================================
• Copy the entire IDE folder from the AppGameKit installation to your Mac
• On the Mac copy of the files, delete all but the following folders:
<MACAGKDIR>/IDE/apps/interpreter
<MACAGKDIR>/IDE/apps/interpreter_ios
<MACAGKDIR>/IDE/apps/interpreter_mac
<MACAGKDIR>/IDE/apps/template_ios
<MACAGKDIR>/IDE/apps/template_mac
<MACAGKDIR>/IDE/common
<MACAGKDIR>/IDE/Help (this is up to you, whether you want local help)
<MACAGKDIR>/IDE/platform/apple
<MACAGKDIR>/IDE/platform/mac
• This next step is very important if you want to link v1085+ (Facebook):
⁃ Navigate to <MACAGKDIR>/IDE/platform/apple/Source/Social Plugins/FacebookSDK
⁃ Follow the instructions in the file named Urgent_ReadMe_Now.txt
• Navigate to \IDE\Apps\interpreter_ios folder and duplicate it
• Rename the duplicate to your chosen app name (i.e. foo)
• Create a directory named 'media' using File->New Folder in Finder, this is where the bytecode and media files will go later
• Navigate into this folder and double click on agkinterpreter.xcodeproj (i.e. \IDE\Apps\foo)
• This should launch XCODE (4.3.2) with the iOS application project
• In order to create a release build, do these steps:
⁃ Click on 'agk_interpreter>' at the very top of the interface (right next to the square 'Stop' button)
⁃ Click on 'Edit scheme…'
⁃ For each item other than 'Build' in the left column, click on it and select 'Release' from the 'Build Configuration' drop down list to the right
⁃ Close the dialog with the 'OK' button
• If you want your compiled project to end up in a friendly directory (the default is quite ugly):
⁃ Select Xcode -> Preferences from main menu
⁃ Click on the "Locations" tab/icon
⁃ Click on the "Advanced…" button
⁃ Select "Custom", click on the select list next to it and select "Relative to Workspace"
⁃ Click on "Done"
⁃ Do yourself a favor and click on the "Text Editing" tab/icon and check "Line numbers", this comes in handy later
⁃ Close the Preferences dialog box
• Click on "Validate Settings" in the middle at the bottom of the interface and click on "Perform Changes" in the popped up dialog (it's up to you whether you enable or disable automatic snapshots in the next pop up)
• Click on the folder icon under tab-like thing with label "agkinterpreter.xcodeproj"
• To rename the basic project:
⁃ Click on "agk_interpreter, 1 target, iOS SDK 5.1" next to white right pointing triangle
⁃ In the area to the right, click on "agkinterpreter" under the word "PROJECT"
⁃ Click on "Build Settings" in the header in the area next to that one
⁃ In the far right column, under the heading "Identity", change 'Project Name' from 'agkinterpreter' to the new name of your application (foo) and then press the enter or return key
⁃ In the "Rename project content items?" dialog that pops up, click on the "Rename" button
⁃ Double click on "agk_interpreter" under "TARGETS" (beneath "PROJECTS")
⁃ Type in your preferred name (should be same as project, for simplicity) and press enter/return key
• Now, to rename the application itself:
⁃ Click on the name under "TARGETS" and select "Build Settings" from the set to the right
⁃ Scroll down to the "Code Signing" header and open the section, if not already opened
⁃ Click on the entry next to "Code Signing Identity"
⁃ Since you will have registered with Apple, created a iPhone Developer ID and downloaded it, it will appear under 'Automatic Profile Selector', select that for now
⁃ Scroll down to the "Packaging" header and open the section, if not already opened
⁃ Double click on "AGK Player" next to "Product Name"
⁃ Type the name you want to use for your app and press the enter/return key
• You probably will want to change the bundle identifier (certainly before you publish):
⁃ Select the target under "TARGETS" and select "Info" on the right
⁃ Double click on "com.thegamecreators.AGKTestApp" and change it to something appropriate for your app. "thegamecreators" should become your indie/company name (no spaces) and "AGKTestApp" should be your application name without spaces
• Select Product > Clean from the main menu (or click {apple}{shift}k)
• Select Product > Build from the main menu (or click {apple}b)
• If all goes well, your application will build successfully
• You can test your new application:
⁃ Select where to run it from the list that appears when you click on the text to the right of the faint right arrow next to "agk_interpreter" near the top of the interface, next to the two buttons (one with a big right triangle and the other with a square)
⁃ Click on the big right triangle
• You should see the AppGameKit Player standby screen on your connected iOS device
• Your connected device could be an iPhone, iPad or 2nd gen iPod
• Quit the application and collect the byte code and media files from your Windows AppGameKit project's media directory
• The byte code and media files should include the BYC file
• Copy these files into the media directory in your new project folder
• Rename the .BYC file to 'bytecode.byc' exactly
• From the project project tree to the left, open up your project so you can see your project files
• Right click on the Resources item and select "Add Files to '<your project>'"
• Enter your project folder and select the media and BYC files you added earlier
• Click the ADD button when promoted to add these files to your project
• Modify the interpreter.cpp file to include the 'bytecode.byc' file:
⁃ Make sure the application tree is open, the right triangle next to the project name in the far left column is changed to a down triangle and a list of directory boxes appears
⁃ Open the "Classes" directory
⁃ Click on 'interpreter.h'
⁃ Add this as the third line (after '#define _H_APP'):
#define STANDALONE
⁃ Save the file
⁃ All being well, when you click Build and Run you will see your Tier 1 BASIC app appear!
• You can find your final application binary at IDE\Apps\yourproject\Build\Products\Release\yourapp
Cheers,
Ancient Lady
