Azure SDK for iOS (October 2022)
The Azure SDK team is pleased to announce our October 2022 client library releases.
2 packages released this month.
Stable Packages (1)
- Communication Chat
Beta Packages (1)
- Communication Calling
Release highlights
Communication Calling 2.3.0-beta.1 Changelog
Features Added
- Azure Communication Services introduces the concept of a
room
for developers who are building structured conversations such as virtual appointments or virtual events. Learn more about rooms here. Get started using rooms by following the quick start guides. - Callkit Integration
- Application will be able to configure call capabilities with
CallKitOptions
. - Application will be able to pass the means to reach a call recipient and the display name with
CallKitRemoteInfo
. - Application will be able to use
reportIncomingCallToCallKit
to handle notification when the app is in kill state. - Support for stopping an incoming call because it was answered in another device, or caller cancelled, etc.
- Dominant Speakers
- Dominant speakers is an extended feature that allows you to obtain a list of the active speakers in the call. The dominant speakers list can change dynamically according to the activity of the participants on the call.
Bugs fixed
- Fix for issue when a call with a host would not end if the host leaves the call.
- Fix for internal update when Call Id changes in the middle of a call.
- Fix for fetching token from background thread blocks the creation of
CallAgent
. - Fix for simulator crash when UI window size is returned as zero.
- Fix for audio not flowing issue when resume ACS call from PSTN call.
- Fixed crash when an invalid token is provided.
- Fix for wrong response with isMuted() method when user is trying to mute ACS participant.
- Fix for issue where local user stops streaming during
connecting
state, remote participant sees them as rendering stream.
Communication Chat 1.3.0 Changelog
New Features
ChatClient
now supports Push Notifications for Chat events- Following methods added to
ChatClient
: startPushNotifications(deviceToken:)
stopPushNotifications()
- Added the prototol
PushNotificationKeyStorage
and the classAppGroupPushNotificationKeyStorage
to support PushNotification Encryption Key Management
Need help
- For reference documentation visit the Azure SDK for iOS documentation.
- For tutorials, samples, quick starts and other documentation, visit the Azure SDK for iOS repository.
- File an issue via Github Issues.
- Check previous questions or ask new ones on
StackOverflow using the
azure
andios
tags.
Latest Releases
View all the latest versions of iOS packages here.
Installation Instructions
To install the latest GA and beta libraries, we recommend you use the Swift Package Manager. As an alternative, you may also integrate the libraries using CocoaPods.
Xcode
To add the Azure SDK for iOS to your application, follow the instructions in Adding Package Dependencies to Your App:
With your project open in Xcode 11 or later, select File > Swift Packages > Add Package Dependency… Enter the clone URL of the Swift Package Manager mirror repository for the library you wish to include (it will have the form SwiftPM-<NAME>
, i.e.: https://github.com/Azure/SwiftPM-AzureCore.git) and click Next. For the version rule, specify the exact version or version range you wish to use with your application and click Next. Finally, place a checkmark next to each client library you wish to use with your application, ensure your application target is selected in the Add to target dropdown, and click Finish.
Swift CLI
To add the Azure SDK for iOS to your application, follow the example in Importing Dependencies:
Open your project’s Package.swift
file and add a new package dependency to your project’s dependencies
section, specifying the clone URL of the Swift Package Manager mirror repository and the version specifier you wish to use:
// swift-tools-version:5.3
dependencies: [
...
.package(name: "AzureCommunicationChat", url: "https://github.com/Azure/SwiftPM-AzureCommunicationChat.git", from: "1.3.0"),
]
Next, add each client library you wish to use in a target to the target’s array of dependencies
:
targets: [
...
.target(
name: "MyTarget",
dependencies: [
"AzureCommunicationChat",
...
]
)
]
Cocoapods
CocoaPods is a dependency manager for Objective-C and Swift projects. You can install it with the following command:
$ [sudo] gem install cocoapods
CocoaPods 1.5+ is required.
To integrate one or more client libraries into your project using CocoaPods, specify them in your Podfile, providing the version specifier you wish to use. To ensure compatibility when using multiple client libraries in the same project, use the same version specifier for all Azure SDK client libraries within the project:
platform :ios, '12.0'
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
target 'MyTarget' do
pod 'AzureCommunicationCalling', '2.3.0-beta.1'
pod 'AzureCommunicationChat', '1.3.0'
...
end
Then, run the following command:
$ pod install
Feedback
If you have a bug or feature request for one of the libraries, please post an issue to GitHub.