https://github.com/twilio/conversations-ios
SPM releases
https://github.com/twilio/conversations-ios
conversations ios sdk twilio twilio-conversations
Last synced: 2 months ago
JSON representation
SPM releases
- Host: GitHub
- URL: https://github.com/twilio/conversations-ios
- Owner: twilio
- Created: 2020-09-21T13:56:22.000Z (about 5 years ago)
- Default Branch: latest
- Last Pushed: 2024-06-28T15:45:34.000Z (over 1 year ago)
- Last Synced: 2024-06-29T00:28:23.120Z (over 1 year ago)
- Topics: conversations, ios, sdk, twilio, twilio-conversations
- Language: Swift
- Homepage: https://www.twilio.com/docs/conversations/ios/changelog
- Size: 42 KB
- Stars: 10
- Watchers: 11
- Forks: 5
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Twilio Conversations for iOS
This repository contains releases for the Twilio Conversations for iOS SDK. These releases can be consumed using Swift Package Manager, CocoaPods or manual integration into your project.
### Mac Catalyst Pilot
If you are interested in Mac Catalyst support please [contact support](https://support.twilio.com/hc/en-us/requests/new).
### Swift Package Manager
You can add Conversations Client for iOS by adding the `https://github.com/twilio/conversations-ios` repository as a Swift Package.
In your Build Settings, you will also need to modify `Other Linker Flags` to include `-ObjC.`
There is a [known issue](https://bugs.swift.org/browse/SR-13343) with consuming binary frameworks distributed via Swift Package Manager. The current workaround to this issue is to add a `Run Script Phase` to the `Build Phases` of your Xcode project. This `Run Script Phase` should come **after** the `Embed Frameworks` build phase. This new `Run Script Phase` should contain the following code:
```sh
find "${CODESIGNING_FOLDER_PATH}" -name '*.framework' -print0 | while read -d $'\0' framework
do
codesign --force --deep --sign "${EXPANDED_CODE_SIGN_IDENTITY}" --preserve-metadata=identifier,entitlements --timestamp=none "${framework}"
done
```
### CocoaPods Integration
We support integration using CocoaPods as well. You can add Twilio Conversations Client to your project using the following example Podfile:
```ruby
source 'https://github.com/CocoaPods/Specs'
platform :ios, '13.0'
target 'TARGET_NAME' do
pod 'TwilioConversationsClient', '~> 3.1'
end
```
Then run `pod install` to install the dependencies for your project.
### Manual Integration
`TwilioConversationsClient.xcframework` is distributed as a dynamic iOS framework that you can drag and drop into your existing projects.
Once you've downloaded and unpacked the XCFramework, navigate to your Xcode project's _General_ settings page. Drag and drop `TwilioConversationsClient.xcframework` onto the _Frameworks_, _Libraries_, and _Embedded Content_ section. Ensure that "_Copy items if needed_" is checked and press Finish. Ensure that "_Embed & Sign_" is selected.
In your Build Settings, you will also need to modify Other Linker Flags to include `-ObjC`.
### Carthage Integration
Carthage is not currently a supported distribution mechanism for Twilio Conversations Client. Carthage does not currently work with `.xcframeworks` as documented [here](https://github.com/Carthage/Carthage/issues/2890). Once Carthage supports binary `.xcframeworks`, Carthage distribution will be re-added.
## Issues and Support
Please file any issues you find here on Github.
Please ensure that you are not sharing any [Personally Identifiable Information(PII)](https://www.twilio.com/docs/glossary/what-is-personally-identifiable-information-pii) or sensitive account information (API keys, credentials, etc.) when reporting an issue.
For general inquiries related to the Conversations SDK you can file a [support ticket](https://support.twilio.com/hc/en-us/requests/new).
## License
Twilio Conversations for iOS is distributed under [TWILIO-TOS](https://www.twilio.com/legal/tos).