Optional - Recreate Example App

This section shows how to make a new XCode project and turn it into an Applin frontend.

Note: This is the slow way to make a new app. The fast way is to follow the instructions in iOS Frontend.

1. Create XCode Project

1. Open XCode
2. "Welcome to Xcode"
   • Click Create a new XCode project
3. "Choose a template for your new project"
   1. Select iOS
   2. Select App
   3. Click Next
4. "Choose options for your new project"
   1. Enter your app's name
   2. Select your Apple Developer team account.
   3. Select Storyboard interface
   4. Select Swift language
   5. Click Next
5. Select the directory to hold the new app directory. Click "Create".

2. Update Files

Xcode's left-hand panel is a tab view displaying "navigators". To display the Project Navigator, click the left-most icon or select View > Navigators > Project from the menu.

1. Delete and Move to Trash each of these items
   • AppDelegate
   • SceneDelegate
   • ViewController
   • Main
   • LaunchScreen
2. Add logo.png
   1. Save logo.png to your computer
   2. In the Project Navigator, right-click on "Info", and click Add Files to "App Name"... and add the logo.png file you saved.
3. Add Main.swift
   1. In the Project Navigator, right-click on "Info", and click New File
   2. "Choose a template for your new file" modal appears
      • Select iOS
      • Select Swift File
      • Click Next
      • Type Main into the "Save As" box
      • Click Create
   3. "Would you like to configure an Objective-C bridging header?" modal appears
      • Click Don't Create
   4. The middle panel shows "Main". Replace the contents with https://github.com/leonhard-llc/applin-ios-example/blob/main/Applin%20Example/Main.swift.

3. Update Configuration

1. Add ApplinIos package
   1. Right-click anywhere in the Project Navigator and click Add Packages
   2. Paste https://github.com/leonhard-llc/applin-ios.git into the search box
   3. The right panel will show "applin-ios"
   4. Click Add Package
   5. "Choose Package Products for applin-ios" modal appears. 1.Click Add Package
2. Use logo.png as the launch screen
   1. In Project Navigator, click on Info
   2. Add the row "Information Property List" > "Launch Screen"
      • Click the + button to add a row
   3. Change the value of row "Information Property List" > "Launch Screen" > "Image Name" to logo.png
3. Stop UIKit from trying to load "Main" storyboard
   1. In Project Navigator, click on Info
   2. Delete the row "Information Property List" > "Application Scene Manifest" > "Scene Configuration" > "Application Session Role" > "Item 0 (Default Configuration)"
      • Hover over the row and click the - button to delete the row
4. Allow app to run on iOS 15 (iPhone 6S) and newer
   1. Open project configuration
      1. In Project Navigator, click on the project, which is top-most item in the Project Navigator It has a blue App Store icon.
      2. Under "PROJECT", click on the app name
   2. Info tab
      1. Change "iOS Deployment Target" to 15.6. This supports iPhone 6S and newer.
5. Remove unused storyboard settings
   1. Open target configuration
      1. In Project Navigator, click on the project, which is top-most item in the Project Navigator It has a blue App Store icon.
      2. Under "TARGETS", click on the app name
   2. Info tab
      • Delete these rows:
        • "Main storyboard file base name"
        • "Launch screen interface file base name"