Skip to content

Update ACS release notes march [deprecated] #2547

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
garchiro7 wants to merge 3 commits into from
Closed

Update ACS release notes march [deprecated] #2547

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7e2bf97
Update ACS release notes march 21
Mar 10, 2021
989b8de
Update review comments
Mar 10, 2021
b1246c9
update android comments
Mar 10, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 58 additions & 7 deletions releases/2021-03/android.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@ The Azure SDK team is pleased to announce our March 2021 client library releases

Comment thread
garchiro7 marked this conversation as resolved.
#### Updates

- _Add packages_
- Azure Communication Services Chat
- Azure Communication Services Common

#### Beta

Expand All @@ -27,20 +28,42 @@ To use the latest GA and beta libraries, refer to the dependency information bel
### Gradle

#### Java

```gradle
// Insert dependencies
dependencies {
...
implementation 'com.azure.android:azure-communication-chat:1.0.0-beta.7'
implementation 'com.azure.android:azure-communication-common:1.0.0-beta.7'
}
```

#### Kotlin

```gradle
// Insert dependencies
dependencies {
...
implementation("com.azure.android:azure-communication-chat:1.0.0-beta.7")
implementation("com.azure.android:azure-communication-common:1.0.0-beta.7")
}
```

### Maven

```xml
<!-- Insert dependencies -->
...
<dependency>
<groupId>com.azure.android</groupId>
<artifactId>azure-communication-chat</artifactId>
<version>1.0.0-beta.7</version>
<type>aar</type>
</dependency>

<dependency>
<groupId>com.azure.android</groupId>
<artifactId>azure-communication-common</artifactId>
<version>1.0.0-beta.7</version>
<type>aar</type>
</dependency>
```

## Feedback
Expand All @@ -49,10 +72,38 @@ If you have a bug or feature request for one of the libraries, please post an is

## Release highlights

### _Package name_

- Major changes only!
### Azure Communication Services Chat
#### 1.0.0-beta.7 ([Change log](https://github.com/Azure/azure-sdk-for-android/blob/master/sdk/communication/azure-communication-chat/CHANGELOG.md#100-beta7-2021-03-09))
#### New features
- Support real time notifications with new methods in ChatClient/ChatAsyncClient:
- startRealtimeNotifications
- stopRealtimeNotifications
- on(chatEventId, listenerId, listener)
- off(chatEventId, listenerId)
- Add a sample chat app under folder samples for testing and playing around chat functionality purpose.

#### Breaking Changes
- Change remove participant API to /chat/threads/{chatThreadId}/participants/:remove
- user id in following classes changed from type CommunicationUserIdentifier to type CommunicationIdentifierModel.
- property initiator in ChatMessageContent renamed to initiatorCommunicationIdentifier.
- property senderId in ChatMessage and ChatMessageReadReceipt renamed to senderCommunicationIdentifier.
- property identifier in ChatParticipant renamed to communicationIdentifier.
- property createdBy in ChatThread renamed to createdByCommunicationIdentifier.
- repeatability-Request-ID in header renamed to repeatability-Request-Id.



Comment thread
garchiro7 marked this conversation as resolved.
### Azure Communication Services Common
#### 1.0.0-beta.7 ([Change Log](https://github.com/Azure/azure-sdk-for-android/blob/master/sdk/communication/azure-communication-common/CHANGELOG.md#100-beta7-2021-03-09))

#### New Features
- Introduce new class `CommunicationAccessToken`.
#### Breaking Changes
- Credential `getToken` returns the newly added `CommunicationAccessToken` object instead of `AccessToken`.
- Renamed 'getRefreshProactively' to 'isRefreshProactively' in 'CommunicationTokenRefreshOptions'
- Removed constructor 'MicrosoftTeamsUserIdentifier(String userId, boolean isAnonymous, CommunicationCloudEnvironment cloudEnvironment)' in 'MicrosoftTeamsUserIdentifier'
- A few classes are made final 'CommunicationTokenCredential', 'CommunicationTokenRefreshOptions', 'CommunicationUserIdentifier', 'MicrosoftTeamsUserIdentifier', 'PhoneNumberIdentifier', 'UnknownIdentifier', 'CommunicationAccessToken'

## Need help

- For reference documentation visit the [Azure SDK for Android documentation](https://azure.github.io/azure-sdk-for-android/).
Expand Down
69 changes: 68 additions & 1 deletion releases/2021-03/dotnet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,12 +24,22 @@ The Azure SDK team is pleased to announce our March 2021 client library releases

Comment thread
garchiro7 marked this conversation as resolved.
[pattern.beta]: # (- ${PackageFriendlyName})

- Communication Chat
- Communication Common
- Communication Identity
- Communication Phone Numbers
- Communication SMS

## Installation Instructions

To install any of our packages, please search for them via `Manage NuGet Packages...` in Visual Studio (with `Include prerelease` checked) or copy these commands into your terminal:

```bash

$> otnet add package Azure.Communication.Chat --version 1.0.0-beta.5
Comment thread
garchiro7 marked this conversation as resolved.
Outdated
$> dotnet add package Azure.Communication.Common --version 1.0.0-beta.5
$> dotnet add package Azure.Communication.Identity --version 1.0.0-beta.5
$> dotnet add package Azure.Communication.PhoneNumbers --version 1.0.0-beta.5
$> dotnet add package Azure.Communication.SMS --version 1.0.0-beta.5
```

[pattern]: # ($> dotnet install ${PackageName} --version ${PackageVersion})
Expand All @@ -42,6 +52,63 @@ If you have a bug or feature request for one of the libraries, please [file an i

[pattern]: # (### ${PackageFriendlyName} ${PackageVersion} [Changelog]${ChangelogUrl}`n${HighlightsBody}`n)


### Azure Communication Administration was deprecated
Comment thread
garchiro7 marked this conversation as resolved.
Outdated

- Phone number administration will be moved into a new package Azure Communication Phone Numbers.
Comment thread
garchiro7 marked this conversation as resolved.
Outdated

### Azure Communication Phone Numbers 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.PhoneNumbers/CHANGELOG.md#100-beta5-2021-03-09)

#### New Features

- Added `PhoneNumberAdministrationClient` (originally was part of the `Azure.Communication.Administration` package).
Comment thread
garchiro7 marked this conversation as resolved.
Outdated
- Added support for Azure Active Directory Authentication.

#### Breaking Changes

- `PhoneNumberAdministrationClient` has been replaced with `PhoneNumbersClient`, which has the same functionality but different APIs. To learn more about how PhoneNumbersClient works, refer to the [README.md](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.PhoneNumbers/README.md)
Comment thread
garchiro7 marked this conversation as resolved.

### Azure Communication Chat 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.Chat/CHANGELOG.md#100-beta5-2021-03-09)

#### New Features

- Added unit test and live test coverage.
Comment thread
garchiro7 marked this conversation as resolved.
Outdated

#### Breaking Changes

- Added support for communication identifiers instead of raw strings.
- Removed support for nullable reference types.

### Azure Communication Common 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.Common/CHANGELOG.md#100-beta5-2021-03-09)

#### Breaking Changes

- Updated `CommunicationTokenRefreshOptions(bool refreshProactively, Func<CancellationToken, string> tokenRefresher, Func<CancellationToken, ValueTask<string>> asyncTokenRefresher = null, string initialToken = null)`
to `CommunicationTokenRefreshOptions(bool refreshProactively, Func<CancellationToken, string> tokenRefresher)`. `asyncTokenRefresher` and `initialToken` are updated to become public properties.
Comment thread
garchiro7 marked this conversation as resolved.

### Azure Communication Identity 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.Identity/CHANGELOG.md#100-beta5-2021-03-09)

#### Breaking Changes

- `CommunicationIdentityClient.IssueToken` and `CommunicationIdentityClient.IssueTokenAsync` are renamed to `GetToken` and `GetTokenAsync`, respectively
- `CommunicationIdentityClient.CreateUserWithToken` and `CommunicationIdentityClient.CreateUserWithTokenAsync` are renamed to `CreateUserAndToken` and `CreateUserAndTokenAsync`, respectively. Their return value is also changed from `Tuple<CommunicationUserIdentifier, string>` to `CommunicationUserIdentifierAndToken`.

### Azure Communication SMS 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/communication/Azure.Communication.Sms/CHANGELOG.md#100-beta4-2021-03-09)

#### New Features

- Added support to create SmsClient with AzureKeyCredential.
- Support for creating SmsClient with TokenCredential.
Comment thread
garchiro7 marked this conversation as resolved.
- Added support for 1:N SMS messaging.
- Added support for tagging SMS messages.
- Send method series in SmsClient are idempotent under retry policy.

#### Breaking Changes

- Updated `Task<Response<SendSmsResponse>> SendAsync(PhoneNumberIdentifier from, PhoneNumberIdentifier to, string message, SendSmsOptions sendSmsOptions = null, CancellationToken cancellationToken = default)`
to `Task<Response<SmsSendResult>> SendAsync(string from, string to, string message, SmsSendOptions options = default)`
- Replaced `SendSmsResponse` with `SmsSendResult`

## Latest Releases

View all the latest versions of .NET packages [here][dotnet-latest-releases].
Expand Down
106 changes: 104 additions & 2 deletions releases/2021-03/java.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,13 +22,47 @@ The Azure SDK team is pleased to announce our March 2021 client library releases

#### Beta

[pattern.beta]: # (- ${PackageFriendlyName})
- Azure Communication Common
- Azure Communication Identity
- Azure Communication Chat
- Azure Communication Phone Numbers
- Azure Communication SMS

## Installation Instructions

To use the GA and beta libraries, refer to the Maven dependency information below, which may be copied into your projects Maven `pom.xml` file as appropriate. If you are using a different build tool, refer to its documentation on how to specify dependencies.

```xml
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-chat</artifactId>
<version>1.0.0-beta.6</version>
</dependency>

<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-common</artifactId>
<version>1.0.0-beta.6</version>
</dependency>

<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-identity</artifactId>
<version>1.0.0-beta.6</version>
</dependency>

<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-phonenumbers</artifactId>
<version>1.0.0-beta.6</version>
</dependency>

<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-sms</artifactId>
<version>1.0.0-beta.4</version>
</dependency>


```

Expand All @@ -40,7 +74,75 @@ If you have a bug or feature request for one of the libraries, please post an is

## Release highlights

[pattern]: # (### ${PackageFriendlyName} ${PackageVersion} [Changelog]${ChangelogUrl}`n${HighlightsBody}`n)
### Azure Communication Administration was deprecated
Comment thread
garchiro7 marked this conversation as resolved.
Outdated

- Phone number administration will be moved into a new package Azure Communication Phone Numbers.
Comment thread
garchiro7 marked this conversation as resolved.

### Azure Communication Phone Numbers 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-phonenumbers/CHANGELOG.md#100-beta6-2021-03-09)

#### New Features

- Added `PhoneNumbersClient` and `PhoneNumbersAsyncClient` (originally was part of the `azure.communication.administration` package).
- Added support for Azure Active Directory Authentication.

#### Breaking Changes

- `PhoneNumberAsyncClient` has been replaced with `PhoneNumbersAsyncClient`, which has the same functionality but different APIs. To learn more about how PhoneNumbersAsyncClient works, refer to the [README.md](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-phonenumbers/README.md).
Comment thread
garchiro7 marked this conversation as resolved.
- `PhoneNumberClient` has been replaced with `PhoneNumbersClient`, which has the same functionality but different APIs. To learn more about how PhoneNumbersClient works, refer to the [README.md](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-phonenumbers/README.md).


Comment thread
garchiro7 marked this conversation as resolved.



### Azure Communication Common 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-common/CHANGELOG.md#100-beta6-2021-03-09)

#### Breaking Changes

- Renamed `CommunicationTokenRefreshOptions.getRefreshProactively()` to `CommunicationTokenRefreshOptions.isRefreshProactively()`
- Constructor for `CommunicationCloudEnvironment` has been removed and now to set an environment value, the `fromString()` method must be called
- `CommunicationCloudEnvironment`, `CommunicationTokenRefreshOptions `, `CommunicationUserIdentifier`, `MicrosoftTeamsUserIdentifier`,
`PhoneNumberIdentifier`, `UnknownIdentifier`, are all final classes now.

### Azure Communication Chat 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-chat/CHANGELOG.md#100-beta6-2021-03-09)

#### New Features

- Updated azure-communication-chat version


### Azure Communication Identity 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-identity/CHANGELOG.md#100-beta6-2021-03-09)

#### New Features

- Added a retryPolicy() chain method to the `CommunicationIdentityClientBuilder`.

#### Breaking Changes

- `CommunicationIdentityClient.createUserWithToken` and `CommunicationIdentityAsyncClient.createUserWithToken` have been renamed to
`CommunicationIdentityClient.createUserAndToken` and `CommunicationIdentityAsyncClient.createUserAndToken`.
- `CommunicationIdentityClient.createUserWithTokenWithResponse` and `CommunicationIdentityAsyncClient.createUserWithTokenWithResponse` have been renamed to
`CommunicationIdentityClient.createUserAndTokenWithResponse` and `CommunicationIdentityAsyncClient.createUserAndTokenWithResponse`.
- `CommunicationUserIdentifierWithTokenResult` class has been renamed to `CommunicationUserIdentifierAndToken`.


### Azure Communication SMS 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/communication/azure-communication-sms/CHANGELOG.md#100-beta4-2021-03-09)

#### New Features

- Added Azure Active Directory authentication support
Comment thread
garchiro7 marked this conversation as resolved.
- Support for creating SmsClient with TokenCredential.
- Added support for 1:N SMS messaging.
- Added support for tagging SMS messages.
- Send method series in SmsClient are idempotent under retry policy.
- Added `SmsOptions`

#### Breaking Changes

- Updated `public Mono<SendSmsResponse> sendMessage(PhoneNumberIdentifier from, PhoneNumberIdentifier to, String message)` to `public Mono<SendSmsResponse> send(String from, String to, String message)`.
- Updated `public Mono<Response<SendSmsResponse>> sendMessageWithResponse(PhoneNumberIdentifier from,List<PhoneNumberIdentifier> to, String message, SendSmsOptions smsOptions, Context context)` to `Mono<Response<SmsSendResult>> sendWithResponse(String from, String to, String message, SmsSendOptions options, Context context)`.
- Replaced `SendSmsResponse` with `SmsSendResult`.



## Need help

Expand Down
63 changes: 60 additions & 3 deletions releases/2021-03/js.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,14 +22,22 @@ The Azure SDK team is pleased to make available the March 2021 client library re

#### Beta

[pattern.beta]: # (- ${PackageFriendlyName})
- Azure Communication Common
- Azure Communication Identity
- Azure Communication Chat
- Azure Communication Phone Numbers
- Azure Communication SMS

## Installation Instructions

To install the packages, copy and paste the below into a terminal.

```bash

$> npm install @azure/communication-common@next
$> npm install @azure/communication-identity@next
$> npm install @azure/communication-chat@next
$> npm install @azure/communication-phone-numbers@next
$> npm install @azure/communication-sms@next
```

[pattern]: # ($> npm install ${PackageName}@${PackageVersion})
Expand All @@ -40,7 +48,56 @@ If you have a bug or feature request for one of the libraries, please post an is

## Release highlights

[pattern]: # (### ${PackageFriendlyName} ${PackageVersion} [Changelog]${ChangelogUrl}`n${HighlightsBody}`n)
### Azure Communication Administration was deprecated

- Phone number administration will be moved into a new package Azure Communication Phone Numbers.
Comment thread
garchiro7 marked this conversation as resolved.

### Azure Communication Phone Numbers 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-phone-numbers/CHANGELOG.md#100-beta4-2021-03-09)

#### Breaking Changes

- Removed `dist-browser` from the output folders. To bundle the Azure SDK libraries, please read our bundling guide: [link](https://github.com/Azure/azure-sdk-for-js/blob/master/documentation/Bundling.md)

### Azure Communication Chat 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-chat/CHANGELOG.md#100-beta5-2021-03-09)

#### Breaking Changes

- Removed `_response` from returned models.
- Updated to @azure/communication-common@1.0.0-beta.6. Now uses `CommunicationIdentifier` in place of `CommunicationUserIdentifier`.
- Swap the parameter order in `ChatThreadClient` constructor.
- Generates `repeatabilityRequestId` if not populated in `createChatThread` operation.

### Azure Communication Common 1.0.0-beta.6 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-common/CHANGELOG.md#100-beta6-2021-03-09)

##### New Features

- Updated @azure/communication-common version.

### Azure Communication Identity 1.0.0-beta.5 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-identity/CHANGELOG.md#100-beta5-2021-03-09)

#### Breaking Changes

- `CommunicationIdentityClient` method `issueToken` renamed to `getToken`.
- `CommunicationIdentityClient` method `createUserWithToken` renamed to `createUserAndToken`.
- Renamed `CommunicationIdentityOptions` to `CommunicationIdentityClientOptions`.
- Removed `_response` from returned models.
- Removed `dist-browser` from the output folders. To bundle the Azure SDK libraries, please read our bundling guide: [link](https://github.com/Azure/azure-sdk-for-js/blob/master/documentation/Bundling.md).

### Azure Communication SMS 1.0.0-beta.4 [Changelog](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/communication/communication-sms/CHANGELOG.md#100-beta4-2021-03-09)

##### New Features

- `SmsClient` added a constructor that supports `TokenCredential`.
- Added support for 1:N SMS messaging.
- Added support for tagging SMS messages.
- `send` method in `SmsClient` is idempotent under retry policy.
-
#### Breaking Changes

- `SendRequest` renamed to `SmsSendRequest`.
- `SendOptions` renamed to `SmsSendOptions` and now has an additional field `tag` to add a custom tag to delivery reports (when enabled).
- `send` no longer returns `RestResponse`, now returns an array of `SmsSendResults`. This contains fields to validate success/failure of each sent message.


## Latest Releases

Expand Down
Loading