Build a Unity Scene

This quick series of steps will show you how to quickly build any of the examples onto your device in just a few minutes

Step 1: Open the Scene

  1. 1.
    Let's use the HelloWorld scene as an example. In your project window, under the Assets folder, find Placenote/Examples/1_HelloWorld and double click on the HelloWorld Scene. This opens the scene in the editor.
  2. 2.
    In the Scene Hierarchy, select PNSessionOrigin and add your API key to the LibPlacenote (Script) in the Inspector panel, as shown in the image below.
Don't have your API key? Get it on your dev portal.

Step 2: Open build settings and choose scene

In the Unity menu, go to File > Build Settings. You will see a build settings window that looks like the image below. First click "Add Open Scenes" to add all scenes in your project to the build list. Select the scene that you plan on building.

Step 3: Configure the Unity Project

Continuing in the Build Settings window, ensure your Build Platform is set to iOS. If not, switch Platform to iOS. This may take a few minutes. Next, click Player Settings and in the inspector panel that opens up, do the following:
  • Make sure the Camera Usage Description is not empty.
  • Make sure the Location Usage Description is not empty.
  • Change the Bundle Identifier (optional).
A bundle identifier lets iOS identify your app. It should be unique if you plan on experimenting with your app regularly.

Step 3: Build the Unity project

Click Build and choose a folder name (such as "App") to save the generated Xcode project.
Useful Tips when building to iOS: After the first build, if you try to rebuild the Unity project, you will need to choose either "replace" or "append" to generate the Xcode project. "Replace" is essentially a clean build, whereas "Append" is faster since it only updates the build with your changes.