Amplify project setup

For this section you will set up a skeleton project so that Amplify categories can be added to it.

1. Create a new project

Open Xcode. From the menu bar, select "File -> New -> Project..."

Select iOS tab, choose Application type as App and then click on Next.

Fill in the following for your project:

• Product Name: MyAmplifyApp
• Interface: SwiftUI
• Language: Swift
• Tap Next

After tapping Next, select where you would like to save your project, then tap Create. In this example, you will choose: ~/Developer

You should now have an empty iOS project without Amplify.

2. Install Amplify Libraries

1import Amplify
2import AWSAPIPlugin
3import AWSDataStorePlugin

1cd ~/Developer/MyAmplifyApp

1pod init

1target 'MyAmplifyApp' do
2  use_frameworks!
3  pod 'Amplify'
4end

1pod install --repo-update

1xed .

3. Provision the backend with Amplify CLI

To start provisioning resources in the backend, change directories to your project directory and run amplify init:

1cd ~/Developer/MyAmplifyApp/
2amplify init

Enter the following when prompted:

1? Enter a name for the project
2    MyAmplifyApp
3? Enter a name for the environment
4    dev
5? Choose your default editor:
6    Visual Studio Code
7? Choose the type of app that you're building
8    ios
9? Do you want to use an AWS profile?
10    Yes
11? Please choose the profile you want to use
12    default

Upon successfully running amplify init, you should see two new created files in your project directory: amplifyconfiguration.json and awsconfiguration.json. These two files must be manually added to your project so that they are bundled with your application. This is required so that Amplify libraries know how to reach your provisioned backend resources.

To add these configuration files to your project, open finder within your project and drag both amplifyconfiguration.json and awsconfiguration.json to the Xcode window, under your project's folder as seen in this screenshot:

• Enable Copy items if needed if not already enabled
• For “Added folders”, have Create groups selected.
• For “Add to targets”, make sure the app target (MyAmplifyApp) is checked.

Click Finish to add these files to your project as shown in this screenshot:

Now you can build (Cmd+b) and run (Cmd+r) your application.

4. Initialize Amplify in the application

Open AppDelegate.swift or MyAmplifyApp.swift and add import Amplify at the top of the file:

1import Amplify

Update the following function to verify that Amplify can be compiled into your project:

1func application(
2    _ application: UIApplication,
3    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
4) -> Bool {
5    do {
6        try Amplify.configure()
7    } catch {
8        print("An error occurred setting up Amplify: \(error)")
9    }
10    return true
11}

Note: If your app conforms to the App protocol, you can use your own AppDelegate class. Implement an AppDelegate and point Swift UI's UIApplicationDelegateAdaptor property wrapper to it, as below.

1class AppDelegate: NSObject, UIApplicationDelegate {
2    func application(
3        _ application: UIApplication,
4        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
5    ) -> Bool {
6        do {
7            try Amplify.configure()
8        } catch {
9            print("An error occurred setting up Amplify: \(error)")
10        }
11        return true
12    }
13}
14@main
15struct MyAmplifyApp: App {
16    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
17
18    var body: some Scene {
19        WindowGroup {
20            ContentView()
21        }
22    }
23}

Build your project (Cmd+b), then you have successfully added the Amplify library to your project and you should be able to run the application.

Optionally, if you'd like to see additional log messages of what amplify is doing during configuration, you can turn on verbose logging before calling Amplify.configure():

1do {
2    Amplify.Logging.logLevel = .verbose
3    // Configure Amplify as usual...
4    try Amplify.configure()
5    // ...

Re-running the application with verbose logging on, you will see the following messages:

1[Amplify] Configuring
2[Amplify] Configuration: nil

Next steps

Congratulations! You've created a skeleton app and are ready to start adding Amplify categories to your application. The following are some categories that you can start to build into your application:

• Analytics - for logging metrics and understanding your users
• API (GraphQL) - for adding a GraphQL endpoint to your app
• API (REST) - for adding a REST endpoint to your app
• Authentication - for managing your users
• DataStore - for making it easier to program for a distributed data store for offline and online scenarios
• Geo - to use location data and map UI components.
• Predictions - to detect text, images, and more!
• Storage - store complex objects like pictures and videos to the cloud.