Accessing the source code for these tutorials

Thank you for choosing the BA3 Altus Mapping Engine — The best mapping engine on the planet for iOS and Android application developers who need amazing performance and flexibility, control of their data, offline support for standard and custom map formats, and real-world tested cockpit reliability!

This guide will help you get started with the Altus Mapping Engine on the iOS platform. If you are developing for Android, please visit our Android getting started page here.

Step 1

Complete source code is supplied for all of the BA3 Altus Mapping Engine tutorials. There is one code branch for each tutorial (e.g. "tutorial3"), as well as a "blankslate" branch that has all of the libraries for the BA3 Altus Mapping Engine linked in, but no code (blankslate displays a white screen). If this is your first time using these tutorials and you want to access the source code, go to a command prompt and run these commands:

git clone
cd BA3MappingEngineTutorials
git checkout blankslate

Step 2

The BA3MappingEngineTutorials.git file is large—expect it to take a minute or two to download depending on the speed of your connection. If the git command is not working on your machine, see this page to turn it on.

To get one of the tutorials, type:

git checkout tutorial3

About once a week, the BA3MappingEngineTutorials.git file gets updated with a new build of the BA3 Altus Mapping Engine, any new tutorials and any necessary corrections. If it has been several weeks since you started the tutorials, or if you cannot checkout one of the tutorials, you should get the latest version. To get the latest version, type:

git checkout master
git pull

Once you do that, you can checkout any of the tutorials as usual.

Step 3

Say that you are ready to move on to Tutorial 4, but you made minor modifications to the code in tutorial 3. Git will not let you checkout tutorial4. In that case, you can type this to discard your changes:

git reset --hard
git checkout tutorial4

If you want to see a list of all of the source code available, type:

git branch --list

You can learn more about the Altus Mapping Engine classes used in this tutorial in the Documentation. If you have any questions about the Altus Mapping Engine, any feature requests or suggestions for improving the Altus Mapping Engine, please send them to [email protected].