\n
Application Identifier<\/h1>\n<\/div>\n\nMake sure your Bundle\/Application Identifier is correct for the API Key you’re using. You can find your project’s Application Identifier by clicking the [Set App\/Bundle ID<\/em>]\u00a0button on the\u00a0Kudan Tracker<\/code>script, or by going to Edit -> Project Settings -> Player and open\u00a0Other Settings<\/em>\u00a0in the iOS tab.<\/p>\nThe Application ID be either:<\/p>\n
\n- The ID you entered when your free key was generated by XLsoft, in the format “com.companyName.productName”.<\/li>\n
- If you are using the Development License Key,\u00a0
com.xlsoft.kudanar<\/code>.
\nClick here<\/a> for the development license key.<\/li>\n<\/ul>\nTo see if the entered API Key is valid for the corresponding Application ID, run the app in Play Mode. View message in the console mentioning whether or not the API Key is valid. Or view in console log when building for iOS\/Android.<\/p>\n
If the Application Identifier is incorrect, the Tracker will not run<\/strong> and camera view will be blank\/black.<\/p>\n![\"\"](\"https:\/\/www.xlsoft.com\/doc\/kudan\/files\/2018\/09\/894906b-BundleIDUnityiOS-193x300.png\")
<\/p>\n<\/div>\n
![\"\"](\"https:\/\/www.xlsoft.com\/doc\/kudan\/files\/2018\/09\/4910774-APIKeyUnity-160x300.png\")
<\/p>\n<\/div>\n
<\/p>\n
\n\n\nCamera Usage Description<\/h1>\n<\/div>\n\nAdd a camera usage description in the appropriate field. Since Kudan uses the camera, the app will crash on iOS 10+ if an app does not contain a usage description.<\/p>\n
![\"\"](\"https:\/\/www.xlsoft.com\/doc\/kudan\/files\/2018\/09\/dcdfff0-CameraUsageDescriptionUnityiOS-124x300.png\")
<\/p>\n<\/div>\n
\nUsage Descriptions<\/h3>\n\nIf you add any extra features to your app that require additional hardware components, such as GPS, remember to add usage descriptions for those to save yourself a headache later.<\/p>\n<\/div>\n<\/div>\n
<\/div>\nAdd BuildHelper<\/h1>\n
Xcode projects, built with Unity 2019 and later, now includes the UnityFramework within the Standard iOS libraries. The Kudan framework supports fat binary, so builds cannot be compiled with Bitcode enabled. This UnityFramework also requires [Enable Bitcode] to be set to [No].<\/p>\n
![\"\"](\"https:\/\/www.xlsoft.com\/doc\/kudan\/files\/2020\/09\/unity2020-ios-xcode-unity-framework-bitcode2.png\")
<\/p>\n
Starting with Unity 2019, you can specify Xcode project settings from Unity by adding the BuildHelper.cs file to your Unity project. Following the steps below.<\/p>\n
In Project pane, create an Editor<\/code> folder in the Assets<\/code> folder by right-clicking and selecting [Create > Folder]. Right-click on the Editor<\/code> folder created, select [Create > C # Script], and name the file BuildHelper.cs<\/code>.<\/p>\n![\"\"](\"https:\/\/www.xlsoft.com\/doc\/kudan\/files\/2020\/09\/unity2020-add-buildhelper.png\")
<\/p>\n
Open BuildHelper.cs<\/code> with Visual Studio or other editor and replace it with the following code.<\/p>\n\r\n#if UNITY_2019_1_OR_NEWER\r\n#if UNITY_IPHONE\r\n\r\nusing System.IO;\r\nusing UnityEditor;\r\nusing UnityEditor.Callbacks;\r\nusing UnityEditor.iOS.Xcode;\r\n\r\npublic class BuildHelper\r\n{\r\n [PostProcessBuildAttribute (1)]\r\n public static void OnPostProcessBuild (BuildTarget target, string path)\r\n {\r\n if (target == BuildTarget.iOS)\r\n {\r\n var projectPath = PBXProject.GetPBXProjectPath (path);\r\n var project = new PBXProject ();\r\n project.ReadFromString (File.ReadAllText (projectPath));\r\n\r\n var targetGUID = project.GetUnityFrameworkTargetGuid ();\r\n project.SetBuildProperty (targetGUID, "ENABLE_BITCODE", "NO");\r\n var iphoneGUID = project.GetUnityMainTargetGuid ();\r\n project.SetBuildProperty (iphoneGUID, "ENABLE_BITCODE", "NO");\r\n\r\n File.WriteAllText (projectPath, project.WriteToString ());\r\n }\r\n }\r\n}\r\n\r\n#endif\r\n#endif\r\n<\/pre>\nBuildHelper sets Enable Bitcode to [No] in the generated Xcode project. Just click [Build And Run].<\/div>\n<\/div>\n<\/div>\n<\/div>\n <\/p>\n
\n<\/div>\nBuild the Xcode project<\/h1>\n<\/div>\n\nBuild the app by going to File -> Build Settings, selecting iOS and clicking Build. Unity will build the selected scenes and produce an XCode project in the selected folder.<\/p>\n
Depending on your versions of Unity and Xcode, you may be able to select Build and Run instead. In this instance, Unity will automatically open the built project in Xcode and run it on a connected device, if possible. This is not always the case, however, so it is usually safer to simply click Build and open the project yourself unless you know for a fact that your particular versions of Unity and Xcode are compatible.<\/p>\n<\/div>\n
\n<\/div>\nSet up the Xcode project<\/h1>\n<\/div>\n\nIn the Xcode project, there are two more things we need to set. If you created the BuildHelper script, skip the first step. First, select the project in the tree view on the left hand side and click the\u00a0Build Settings<\/em>\u00a0tab. Scroll down to the\u00a0Build Options<\/em>\u00a0section and find the entry marked\u00a0Enable Bitcode<\/em>. Set it to\u00a0NO<\/strong>. Kudan’s framework is a fat binary and cannot be compiled in an app with bitcode enabled. Skip this step if you created the BuildHelper script.\n<\/div>\n![\"\"](\"https:\/\/www.xlsoft.com\/doc\/kudan\/files\/2018\/09\/57eb259-XcodeDisableBitcode-300x158.png\")
<\/p>\n<\/div>\n
Next, check that you have a valid Provisioning Profile. With Xcode 8 and later, profiles will automatically be taken care of by signing into Apple, so all you should need to do is select a development team in the\u00a0Signing<\/em>\u00a0section of the\u00a0General<\/em>\u00a0tab. In older versions of Xcode, you’ll have to make sure that the correct profile has been selected, or that you are using a wildcard Provisioning Profile.<\/p>\n<\/div>\n![\"\"](\"https:\/\/www.xlsoft.com\/doc\/kudan\/files\/2018\/09\/e84d93e-XcodeSigning-300x72.png\")
<\/p>\n
<\/p>\n
If everything has been set up, click the play button in the upper left corner of the screen and the app should build and run. If you have a device connected to your machine via USB, the app will run on that device once the build has finished.<\/p>\n","protected":false},"excerpt":{"rendered":"
This quick tutorial will show you how to set up your Unity project to build for the iOS platform. Application Identifier Make sure your Bundle\/Application Identifier is correct for the API Key you’re using. You can find your project’s Application Identifier by clicking the [Set App\/Bundle ID]\u00a0button on the\u00a0Kudan Trackerscript, or by going to Edit … Read moreUnity Building The App for iOS<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"bekko_page_header":""},"_links":{"self":[{"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/pages\/273"}],"collection":[{"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/comments?post=273"}],"version-history":[{"count":24,"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/pages\/273\/revisions"}],"predecessor-version":[{"id":2469,"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/pages\/273\/revisions\/2469"}],"wp:attachment":[{"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/media?parent=273"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
Make sure your Bundle\/Application Identifier is correct for the API Key you’re using. You can find your project’s Application Identifier by clicking the [Set App\/Bundle ID<\/em>]\u00a0button on the\u00a0 The Application ID be either:<\/p>\n To see if the entered API Key is valid for the corresponding Application ID, run the app in Play Mode. View message in the console mentioning whether or not the API Key is valid. Or view in console log when building for iOS\/Android.<\/p>\n If the Application Identifier is incorrect, the Tracker will not run<\/strong> and camera view will be blank\/black.<\/p>\n <\/p>\n Add a camera usage description in the appropriate field. Since Kudan uses the camera, the app will crash on iOS 10+ if an app does not contain a usage description.<\/p>\n If you add any extra features to your app that require additional hardware components, such as GPS, remember to add usage descriptions for those to save yourself a headache later.<\/p>\n<\/div>\n<\/div>\n Xcode projects, built with Unity 2019 and later, now includes the UnityFramework within the Standard iOS libraries. The Kudan framework supports fat binary, so builds cannot be compiled with Bitcode enabled. This UnityFramework also requires [Enable Bitcode] to be set to [No].<\/p>\n Starting with Unity 2019, you can specify Xcode project settings from Unity by adding the BuildHelper.cs file to your Unity project. Following the steps below.<\/p>\n In Project pane, create an Open <\/p>\n Build the app by going to File -> Build Settings, selecting iOS and clicking Build. Unity will build the selected scenes and produce an XCode project in the selected folder.<\/p>\n Depending on your versions of Unity and Xcode, you may be able to select Build and Run instead. In this instance, Unity will automatically open the built project in Xcode and run it on a connected device, if possible. This is not always the case, however, so it is usually safer to simply click Build and open the project yourself unless you know for a fact that your particular versions of Unity and Xcode are compatible.<\/p>\n<\/div>\n In the Xcode project, there are two more things we need to set. If you created the BuildHelper script, skip the first step. First, select the project in the tree view on the left hand side and click the\u00a0Build Settings<\/em>\u00a0tab. Scroll down to the\u00a0Build Options<\/em>\u00a0section and find the entry marked\u00a0Enable Bitcode<\/em>. Set it to\u00a0NO<\/strong>. Kudan’s framework is a fat binary and cannot be compiled in an app with bitcode enabled. Skip this step if you created the BuildHelper script.\n<\/div>\n Next, check that you have a valid Provisioning Profile. With Xcode 8 and later, profiles will automatically be taken care of by signing into Apple, so all you should need to do is select a development team in the\u00a0Signing<\/em>\u00a0section of the\u00a0General<\/em>\u00a0tab. In older versions of Xcode, you’ll have to make sure that the correct profile has been selected, or that you are using a wildcard Provisioning Profile.<\/p>\n<\/div>\n <\/p>\n If everything has been set up, click the play button in the upper left corner of the screen and the app should build and run. If you have a device connected to your machine via USB, the app will run on that device once the build has finished.<\/p>\n","protected":false},"excerpt":{"rendered":" This quick tutorial will show you how to set up your Unity project to build for the iOS platform. Application Identifier Make sure your Bundle\/Application Identifier is correct for the API Key you’re using. You can find your project’s Application Identifier by clicking the [Set App\/Bundle ID]\u00a0button on the\u00a0Kudan Trackerscript, or by going to Edit … Read moreUnity Building The App for iOS<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"bekko_page_header":""},"_links":{"self":[{"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/pages\/273"}],"collection":[{"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/comments?post=273"}],"version-history":[{"count":24,"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/pages\/273\/revisions"}],"predecessor-version":[{"id":2469,"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/pages\/273\/revisions\/2469"}],"wp:attachment":[{"href":"https:\/\/www.xlsoft.com\/doc\/kudan\/wp-json\/wp\/v2\/media?parent=273"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Kudan Tracker<\/code>script, or by going to Edit -> Project Settings -> Player and open\u00a0Other Settings<\/em>\u00a0in the iOS tab.<\/p>\n\n
com.xlsoft.kudanar<\/code>.
\nClick here<\/a> for the development license key.<\/li>\n<\/ul>\n<\/p>\n<\/div>\n<\/p>\n<\/div>\nCamera Usage Description<\/h1>\n<\/div>\n
<\/p>\n<\/div>\nUsage Descriptions<\/h3>\n
Add BuildHelper<\/h1>\n
<\/p>\nEditor<\/code> folder in the Assets<\/code> folder by right-clicking and selecting [Create > Folder]. Right-click on the Editor<\/code> folder created, select [Create > C # Script], and name the file BuildHelper.cs<\/code>.<\/p>\n<\/p>\nBuildHelper.cs<\/code> with Visual Studio or other editor and replace it with the following code.<\/p>\n\r\n#if UNITY_2019_1_OR_NEWER\r\n#if UNITY_IPHONE\r\n\r\nusing System.IO;\r\nusing UnityEditor;\r\nusing UnityEditor.Callbacks;\r\nusing UnityEditor.iOS.Xcode;\r\n\r\npublic class BuildHelper\r\n{\r\n [PostProcessBuildAttribute (1)]\r\n public static void OnPostProcessBuild (BuildTarget target, string path)\r\n {\r\n if (target == BuildTarget.iOS)\r\n {\r\n var projectPath = PBXProject.GetPBXProjectPath (path);\r\n var project = new PBXProject ();\r\n project.ReadFromString (File.ReadAllText (projectPath));\r\n\r\n var targetGUID = project.GetUnityFrameworkTargetGuid ();\r\n project.SetBuildProperty (targetGUID, "ENABLE_BITCODE", "NO");\r\n var iphoneGUID = project.GetUnityMainTargetGuid ();\r\n project.SetBuildProperty (iphoneGUID, "ENABLE_BITCODE", "NO");\r\n\r\n File.WriteAllText (projectPath, project.WriteToString ());\r\n }\r\n }\r\n}\r\n\r\n#endif\r\n#endif\r\n<\/pre>\nBuild the Xcode project<\/h1>\n<\/div>\n
Set up the Xcode project<\/h1>\n<\/div>\n
<\/p>\n<\/div>\n<\/p>\n