🍎iOS Configuration

🕒 Estimated Reading Time: 2 minutes
📂 Location: Configurations & Customization → iOS Configuration

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

📲 Setting Up iOS for ProKit Project

This guide explains the step-by-step process for configuring your iOS app in Xcode for your ProKit mobile application.

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

✅ 1. Open the iOS Project in Xcode

To begin setting up your app for iOS, follow these steps:

1. Open Xcode on your Mac.
2. Click File → Open or use shortcut Cmd + O.
3. Navigate to your Flutter project folder.
4. Open the ios directory.
5. Look for a file with the extension “.xcworkspace” or “.xcodeproj” within the ios folder.
   This file represents your Xcode project for the Flutter app.
6. Select the “.xcworkspace” or “.xcodeproj” file and click on the “Open” button.

✅ Make sure you’ve already installed Flutter and all iOS dependencies before opening in Xcode.

✏️ 2. Change the Bundle Name

The Bundle Name is the name that appears under your app icon on iOS devices.

To change it:

1. Select your project file icon in the Group and Files panel.
2. In the Xcode navigation pane, find and select your project file (usually denoted by the blue icon with your project name).
3. In the main editor area, you should see the project settings. Select the target for which you want to change the Bundle Name. Targets are usually listed under the Targets section in the project settings.
4. With the target selected, navigate to the “Info” tab.
5. Scroll down to the “Custom iOS Target Properties” section, and locate the “Bundle Name” key.
6. Double-click on the value field next to “Bundle Name” and enter the desired name for your bundle.
7. After changing the Bundle Name, make sure to save your changes by clicking on the “File” menu and selecting “Save” or using the keyboard shortcut “Command + S”.

🔐 3. Change the Bundle Identifier

The Bundle Identifier must be unique for every iOS app and is required for publishing on the App Store.

To update:

1. Select your project file icon in the Group and Files panel.
2. Under your Target, open the General tab.
3. In the Identity section, update the Bundle Identifier (e.g., com.yourcompany.kivicare).

🖼️ 4. Change the App Icon

To change your app’s launcher icon:

1. Visit the Website –
   • Icon Kitchen
2. Follow these steps:
   • Choose Asset Type
   • Basic Configuration
   • Set Device Type
   • Download the ZIP file
3. Inside the zip, you will find an ios folder.
4. Copy everything from it and paste it into:
   ios/Runner/Assets.xcassets/AppIcon.appiconset

🔐 5. Enable Google Sign-In

To set up Google Login for your app:

1. Register your app on Firebase.
2. Make sure that GoogleService-Info.plist is the name of the file you downloaded from Firebase.
3. Move or copy the GoogleService-Info.plist into the [My_project]/ios/Runner folder.
4. Open Xcode, right-click on the Runner directory, and select Add files into Runner.
5. Select the GoogleService-Info.plist file from the file manager.
6. In the dialog that appears, select the Runner target.
7. Add the following CFBundleURLTypes attributes into the [My_project]/ios/Runner/Info.plist file.
8. Run your project.

Open Info.plist file in Xcode.

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <!-- Replace this value with the REVERSED_CLIENT_ID copied from GoogleService-Info.plist -->
            <string>Enter your REVERSED_CLIENT_ID</string>
        </array>
    </dict>
</array>

🔍 Replace YOUR_REVERSED_CLIENT_ID with the value from your .plist file.

🍏 6. Enable Apple Sign-In

To enable Sign in with Apple:

1. Open the project in Xcode.
2. Go to the Project Editor, choose your target, and open the Signing & Capabilities panel.
3. Click the Library button (+) to open the Capabilities library (or choose Editor > Sign in with Apple).
4. Run your project.

🔔 7. Enable iOS Notifications (APNs)

To set up push notifications:

1. Follow Apple APNs Certificate setup (Step 3 in Firebase setup).
2. In your project, open:
   ios/Runner/AppDelegate.swift
3. Add the following code inside the AppDelegate class:

if #available(iOS 10.0, *) {
  UNUserNotificationCenter.current().delegate = self as? UNUserNotificationCenterDelegate
}

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

🍎 Video Reference: How to Build ProKit Flutter App for iOS

This video walkthrough starts with an introduction and explains how to set the path to the iOS folder and run pod install to fetch all required dependencies. It then demonstrates how to open the project in Xcode and proceed with customization. You’ll learn how to change the Bundle Identifier, update the Application Version Code, and rename the Application in the info.plist file. The video also shows how to change the Application Icon and finally how to run the app on an iOS simulator or device.

Watch the full video here:

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

✅ Done!

🎉 You’ve successfully completed your iOS configuration for the ProKit app. Your app is now ready for testing and deployment on iOS devices.