<main>
<article class="userContent">
<p>This documented is intended as a technical guide for the iOS developers building and personalizing the WhiteLabel version of the AssistAR app. </p><p>It is expected that the reader has knowledge about core iOS concepts, like bundle ids, code signing and generation of mobile provisioning profiles.</p><p><br></p><h2 data-id="pre-requisites">Pre requisites</h2><p><br></p><h4 data-id="assistar-license">AssistAR License</h4><p>The Application can only run with a valid AssistAR Professional license. Please check your current license is the right one or contact sales for upgrading or requesting a free trial.</p><p><br></p><h4 data-id="sdk-token">SDK Token</h4><p>Obtain a mobile SDK token from the TeamViewer Management console (login.teamviewer.com).</p><p><br></p><h4 data-id="application-bundle-id">Application Bundle ID</h4><p>You need to create a bundle ID in your Apple Developer Program. Required entitlements: Associated Domains.</p><p><br></p><h4 data-id="provisioning-profiles">Provisioning Profiles</h4><p>You need to create a developer provisioning profile, and a distribution (AppStore) provisioning profile.</p><p><br></p><h2 data-id="configuration">Configuration</h2><p>The configuration file is in the path: BaseAppConfig.xcconfig</p><p><br></p><h4 data-id="sdk-token-1">SDK Token</h4><p>Change the key named: TV_SDK_TOKEN and replace it with your token.</p><p><br></p><h4 data-id="application-bundle-id-1">Application Bundle ID</h4><p>Change the key named: PRODUCT_BUNDLE_IDENTIFIER and replace it with your bundle id.</p><p><br></p><h4 data-id="application-name">Application Name</h4><p>Change the key named: PRODUCT_NAME and change it with your app name.</p><p><br></p><h4 data-id="provisioning-profiles-1">Provisioning Profiles</h4><p>Change the setting in XCode regarding the code signing so that you choose the provisioning profiles that you created for development and for distribution.</p><p><br></p><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/2CY8UUHUYWA1/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/2CY8UUHUYWA1/image.png" alt="image.png" height="314" width="977" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p></p><p><br></p><h2 data-id="personalization">Personalization</h2><p><br></p><h4 data-id="application-icon">Application Icon</h4><p>If you need to change the Application icon, you need to generate an iOS App Icon bundle using any tool. Once you have the Bundle, you can drag and drop it in the resource asset catalog.</p><p><br></p><p>Once the bundle is in the assets, change: ASSETCATALOG_COMPILER_APPICON_NAME to the name of the AppIcon bundle.</p><p><br></p><h4 data-id="onboarding-images">Onboarding images</h4><p>You can replace the images and the text for the onboarding screens, by adding the images you need to the asset catalog, and modifying the following keys in the configuration file:</p><p><br></p><h4 data-id="images">Images</h4><p>TV_ONBOARDING_SLIDE_I to TV_ONBOARDING_SLIDE_IV</p><p><br></p><h4 data-id="texts">Texts</h4><p>TV_ONBOARDING_TEXT_I to TV_ONBOARDING_TEXT_IV</p><p><br></p><h4 data-id="panorama-image">Panorama Image</h4><p>You can add a fisheye image to be used as the main Application background. You can also disable this option. </p><p>Add the high-resolution fisheye (360) image to the assets catalog, then specify that asset name in the configuration file under the following key: TV_PANORAMA_ASSET_NAME</p><p><br></p><h4 data-id="launch-screen-logo">Launch Screen Logo</h4><p>Add an image into the assets and edit the setting named: TV_LAUNCH_SCREEN_ASSET_NAME</p><p><br></p><h4 data-id="colors">Colors</h4><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/W3YVGPNH9WR4/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/W3YVGPNH9WR4/image.png" alt="image.png" height="944" width="1537" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><h2 data-id="build-tools">Build Tools</h2><p>We provide the WhiteLabel app with a couple of small python scripts to help changing the colors in the asset files and storyboards. It is not mandatory to use it. You can add this as part of your build script.</p><p><br></p><h4 data-id="example-input-json-file%3A">Example input JSON file:</h4><p>{</p><p> “WLText”: “FFFFFF”,</p><p> “WLBackgound”: “000000”</p><p>}</p><p><br></p><h4 data-id="colors.py">colors.py</h4><p>Takes a JSON colors definition file and replaces the colors in the Assets folder. Usage:</p><p><br></p><p>> python3 colors.py colorMap.json “ApplicationLayer/Assets.xcassets/Whitelabel/”</p><p><br></p><h4 data-id="storyboards.py">storyboards.py</h4><p>Takes a JSON colors definition file and applies this to a given storyboard. Usage:</p><p><br></p><p>> python3 storybaords.py colorMap.json ApplicationLayer/Base.lproj/LaunchScreen.storyboard</p><p><br></p><h4 data-id="all-configuration-settings">All configuration settings</h4><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/3O4FJ4RBXXGI/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/3O4FJ4RBXXGI/image.png" alt="image.png" height="1279" width="1277" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p>
</article>
</main>