Configuration Manager: iOS Configuration
You can publish a mobile application that you developed in Kuika on the App Store. To publish the application you have developed on the App Store, you must make the necessary adjustments for the iOS operating system via Kuika Configuration Manager.
This training content consists of the following topics;
- 1.Creating a new Configuration in Kuika for the iOS operating system
- 2.Adding App information to publish the app to the App Store
- 3.Adding Backend Settings to publish the app to the App Store
- 4.Adding App Store settings to publish the app to the App Store
- 5.Adding Permission Tags to publish apps to App Store
- 6.Add Orientation and Image settings to publish the app to the App Store
To create a new configuration, open the Configuration Manager view mode from within the project you are working on at platform.kuika.com. Select iOS from the Web UI, iOS, Android, and API options under the Create a new configuration heading in the Configuration Manager view mode. Name the configuration via the text input box that opens at the bottom and click the "CREATE" button.
IMG 01: Configuration Manager screenshot
On the screen that comes up, you must provide information to prepare your application for publication.
IMG 02: iOS Configuration screenshot
- You must enter the name of the application that you want the application you developed to be displayed in the device in the text input opposite the “Name” heading under the App tab.
- Enter the information on which URL the application you developed will connect to the Backend via “Backend URL”.
- The “Bundle ID” title on the screen is a unique keyword that distinguishes your application from other applications. It is recommended to use the Bundle ID structure as "com.workspacename.applicationname".
- The “Version” header is the version information of the application. The version information should be entered as “1.0.0”.
In the application you developed, you need to select the Backend Configurations and select "Configuration" in Configuration Manager.
IMG 03: iOS Configuration Backend Settings selection screenshot
- To select Configuration, click the drop-down menu opposite the Configuration heading under the "Backend Settings" tab.
- Select the relevant one among the "Configuration" options in the drop-down menu.
The next step that awaits you as you prepare your application for publication is the API connection. This link provides the connection of the application to AppMachine. Click the drop-down menu opposite “Connect API” under the App Store Settings tab to enable the connection. Open the link page by clicking the “ADD NEW” option in the menu that opens.
You must fill in the requested information on the pop-up screen titled "App Store Connect API Setting".
IMG 04: Entering App Store Connect API Setting information on the pop-up that opens
- Enter the name of the App Store Connect Api Setting you developed in the text input opposite "Name".
You need to log into Apple Account Manager and Apple Developer to fill in other information on this screen. You need to get some information from the pages.
To get Issuer Id and P8 file;
- Apple Account Manager page and log in with your Apple Developer account.
- Users and Access Page after login.
- "Keys" button on the page that opens. You can access the " Issuer Id" information on the "Keys" page that opens.
App Store Connect API Key can only be created by Account Holder.
- the API Key you created only once with the “P8” extension. For this reason, you should keep this file well and you should never change the filename. Go back to Kuika and upload the P8 file you downloaded by clicking the "Upload" button next to the "P8 File" heading.
- Apple ID is the credential of the developer account you own.
- There are some steps you need to take to access the App Store Connect Team ID information. You can follow the prepared instruction to perform the operations. Enter the App Store Connect Team ID information you received by following the instruction in the relevant field in Kuika.
The other information you will need for App Store Connect API Setting is “Developer Team Id”.
- For the Developer Team Id, you must first sign into the Apple developer center.
- Open the Account page by clicking the Account button and scrolling down to the Membership Details on the page that opens.
- You can access the "Team Id" information in the membership details section. Enter the Team Id information you have accessed in the relevant field in Kuika.
You can choose TestFlight or Appetize from the drop-down menu next to the Publish Type heading.
- The TestFlight option can directly connect to the App Store based on the information you enter. For testing, the .ipa file is also prepared and sent to the App Store.
- The Appetize option, on the other hand, requires the "Appetize API Token" information. If you prefer to use Appetize, log in to your Appetize account and get the “Appetize API Token” information and fill in the relevant field in Kuika. You can follow the instruction provided by Appetize to open an Appetize account and access API Key information.
If the application you developed has "Camera" usage, "Location" access and "Notification" sending functions, you need to ask permission from the user for these functions. At this point, in the “Permission Labels” section on the screen, you should explain in detail how and why these permissions will be obtained. Click the drop-down menu opposite the headings under “Permission Labels” to fill in this information. Click “ADD NEW” in the menu that opens. Enter the permission title and content information on the pop-up screen.
The language options in your application will appear on this screen. You should prepare the permission content in the languages that the application has. If you add a new language to your app, you must add the permission content again to correspond to the language you added.
IMG 05: Entering permission labels on the pop-up that opens
"Orientation" tab to manage the screen orientations of the application. These settings are;
- Both horizontal and vertical use
- Vertical use only
- Horizontal use only
is in the form.
You can add an icon or logo to the "Splash" screen of the application. You can also change the background color on the splash screen. You also need to add an “App Icon” for your app.
IMG 06: Orientation and visual settings screenshot
Follow the steps below to add an icon or logo to the “Splash” screen of the application, change the background color and add “App Icon”.
IMG 07: Orientation and visual settings Media Gallery screenshot
- "CHANGE” button under the Splash image to add an “icon” or “logo” to the “Splash screen” of the application.
- You can upload an image in “PNG” file format via the “Media Gallery” pop-up screen. The images you have added before will also be listed in the Media Gallery.
- Complete the process of adding an image to the Splash screen by clicking on the image listed in the Media Gallery that you want to use.
- “Default” size or “Stretch” size via the drop-down menu opposite the “Image Fit” heading.
- To change the background color of the splash screen, fill the area opposite the "Splash Color" heading with the "Hex" code of the color you want to use.
- To add your application icon, you must click the “CHANGE” button opposite the “App Icon” heading and upload your application icon in “square format” to the opened Media Gallery.
- Complete the process of adding an application icon by clicking the icon listed in the Media Gallery that you want to use.
After filling in all the required fields, click the “CREATE” button to create the iOS Configuration settings.
IMG 08: Configuration Manager list screenshot
The iOS Configuration you created will be added to the menu on the left of the Configuration screen. Then, to edit the Configuration settings, you can click on the relevant Configuration added to the left menu and perform the editing operations.