Overview 📖
Welcome to the Swift Heroes Stream Workshop! You will be adding Stream’s real-time chat to a SwiftUI application and then have some fun modifying the resulting app.
Once you completed this code lab, you will be able to do the following:
- Have a basic understanding of Stream and chat
- Familiarity with Stream Chat API
- Have a fully functional chat experience using Stream
- Tweak the look and feel of your App by using the extensive theming options available in our SwiftUI Chat SDK.
Make sure to go through this codelab all the way to the end. There is a some swag potential if you complete this Codelab before the 12th of April 2022.
Prerequisites 🧬
Before starting this workshop, please ensure you have the following:
- Git
- Xcode toolchain installed
Creating a project
To start with the iOS SwiftUI SDK, open Xcode and create a new project.
- Create a new Swift project in Xcode 13
- Choose iOS from the list of platforms
- Choose the "App" template
- Use SwiftUIChatDemo for the project name
- Select "SwiftUI" in the Interface option
We are going to use the Swift Package Manager to fetch the SDK. If you'd like, the SDK can also be installed with CocoaPods. You can find more information on using CocoaPods on the SDK doc pages.
- Select "Add Packages…" in File menu
- Paste the URL
https://github.com/getstream/stream-chat-swiftui - In the option "Dependency Rule" choose "Branch", in the single text input next to it, enter "main"
- Choose "Add Package" and wait for the dialog to complete
- Only select "StreamChatSwiftUI" and select "Add Package" again
Add Usage Descriptions to Info.plist
Add the NSPhotoLibraryUsageDescription key in your Info.plist with a description of use. Add the NSPhotoLibraryAddUsageDescription key in your Info.plist with a description of use. Add the NSCameraUsageDescription key in your Info.plist with a description of use.
You now have an empty project with the SwiftUI SDK as a dependency. Let's get started by displaying some content.
