|
1 | | -# LocalStack .NET Client Change Log |
| 1 | +# LocalStack .NET Client v2.x Change Log |
| 2 | + |
| 3 | +This document outlines the changes, updates, and important notes for the LocalStack .NET Client v2.x series, including the latest preview release. |
| 4 | + |
| 5 | +See v1.x change log for previous versions: [CHANGELOG.md](https://github.com/localstack-dotnet/localstack-dotnet-client/blob/sdkv3-lts/CHANGELOG.md) |
2 | 6 |
|
3 | 7 | ### [v2.0.0-preview1](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v2.0.0-preview1) |
4 | 8 |
|
|
39 | 43 | - **Framework Requirement**: .NET Framework 4.7.2 or higher is now required (upgrade from 4.6.2). |
40 | 44 |
|
41 | 45 | --- |
42 | | - |
43 | | -### [v1.6.0](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.6.0) |
44 | | - |
45 | | -#### 1. General |
46 | | - |
47 | | -- **Framework Support Updates:** |
48 | | - - **.NET 9** support added. |
49 | | - - **Deprecated** support for **.NET 6**. |
50 | | - - Continued support for **.NET Standard 2.0** to maintain compatibility with older .NET versions. |
51 | | - |
52 | | -- **Functional Tests Enhancements:** |
53 | | - - **Removed** tests for legacy LocalStack versions and versions **v1.3.1** and **v2.3.2**. |
54 | | - - **Note:** LocalStack.NET no longer guarantees compatibility with v1 and v2 series. |
55 | | - - **Added** functional test support for LocalStack versions: |
56 | | - - **v3.7.1** |
57 | | - - **v4.3.0** |
58 | | - |
59 | | -- **Package Updates:** |
60 | | - - **AWSSDK.Core** minimum version set to **3.7.402**. |
61 | | - |
62 | | -- **Testing Compatibility:** |
63 | | - - Successfully tested against LocalStack versions: |
64 | | - - **v3.7.1** |
65 | | - - **v4.3.0** |
66 | | - |
67 | | -#### 3. Warnings |
68 | | - |
69 | | -- **Breaking Changes Postponed:** |
70 | | - - The planned breaking changes have been postponed to the next release. |
71 | | - - **Important:** Users should anticipate some breaking changes in the next release due to the removal of legacy support and configuration updates. |
72 | | - |
73 | | -### [v1.5.0](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.5.0) |
74 | | - |
75 | | -#### 1. New Features |
76 | | - |
77 | | -- **Added Endpoints from [Localstack Python Client](https://github.com/localstack/localstack-python-client) v2.7:** |
78 | | - - **RAM** |
79 | | - - **AppConfigData** |
80 | | - - **Pinpoint** |
81 | | - - **EventBridge Pipes** |
82 | | - |
83 | | -#### 2. General |
84 | | - |
85 | | -- **Framework Support Updates:** |
86 | | - - **.NET 8** and **.NET 4.6.2** support added. |
87 | | - - **Deprecated** support for **.NET 7** and **.NET 4.6.1**. |
88 | | - - Continued support for **.NET Standard 2.0** to maintain compatibility with older .NET versions. |
89 | | - - **Upcoming Changes:** |
90 | | - - In the next release, **.NET 6** support will be removed as it reaches end-of-life in November 2024. |
91 | | - |
92 | | -- **Functional Tests Enhancements:** |
93 | | - - **Removed** tests for legacy LocalStack versions and versions **v2.0** and **v2.2**. |
94 | | - - **Note:** LocalStack.NET no longer guarantees compatibility with these versions. |
95 | | - - **Added** functional test support for LocalStack versions: |
96 | | - - **v2.3** |
97 | | - - **v3.4** |
98 | | - - **v3.7.1** |
99 | | - - **New Tests:** |
100 | | - - Introduced new tests for **CloudFormation**. |
101 | | - |
102 | | -- **Package Updates:** |
103 | | - - **AWSSDK.Core** minimum version set to **3.7.400.30**. |
104 | | - |
105 | | -- **Testing Compatibility:** |
106 | | - - Successfully tested against LocalStack versions: |
107 | | - - **v1.3.1** |
108 | | - - **v2.3** |
109 | | - - **v3.4** |
110 | | - - **v3.7.1** |
111 | | - |
112 | | -#### 3. Warnings |
113 | | - |
114 | | -- **Breaking Changes Postponed:** |
115 | | - - The planned breaking changes have been postponed to the next release. |
116 | | - - **Important:** Users should anticipate some breaking changes in the next release due to the removal of legacy support and configuration updates. |
117 | | - |
118 | | -### [v1.4.1](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.4.1) |
119 | | - |
120 | | -#### 1. New Features |
121 | | - |
122 | | -- **Update Packages and Multi LocalStack Support:** |
123 | | -- New endpoints added from the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v2.3: |
124 | | - - EMRServerless |
125 | | - - Appflow |
126 | | - - Keyspaces |
127 | | - - Scheduler |
128 | | - |
129 | | -#### 2. Bug Fixes and Investigations |
130 | | - |
131 | | -- **Investigation and Fixes:** |
132 | | - - Started investigating issues #23 and #24. |
133 | | - - Bugs have been fixed with [this PR](https://github.com/localstack/localstack/pull/8962) by LocalStack. |
134 | | - - Fixed legacy LocalStack container wait strategy for functional tests. |
135 | | - |
136 | | -#### 3. General |
137 | | - |
138 | | -- **New Solution Standards:** |
139 | | - - Introduced new solution-wide coding standards with various analyzers. |
140 | | -- **Code Refactoring According to New Standards:** |
141 | | - - Libraries, sandbox projects, build projects, and test projects have been refactored to adhere to the new coding standards. |
142 | | - - Moved remaining using directives to GlobalUsings.cs files. |
143 | | -- **Centralized Package Management:** |
144 | | - - Managed package versions centrally to resolve issue #28. |
145 | | -- **Package Updates:** |
146 | | - - Updated analyzer packages. |
147 | | - - Updated test packages. |
148 | | - - AWSSDK.Core set to 3.7.201 as the minimum version. |
149 | | -- Tested against LocalStack v1.3.1, v2.0, and the latest containers. |
150 | | - |
151 | | -#### 4. Warnings |
152 | | - |
153 | | -- **Legacy LocalStack Versions:** |
154 | | - - This version will be the last to support Legacy LocalStack versions. |
155 | | -- **.NET 4.6.1 Support:** |
156 | | - - .NET 4.6.1 support will be removed in the next release and replaced with .NET 4.6.2. |
157 | | -- **Breaking Changes Ahead:** |
158 | | - - Users should anticipate some breaking changes in the next release due to the removal of Legacy support and changes in configuration. |
159 | | - |
160 | | -### [v1.4.0](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.4.0) |
161 | | - |
162 | | -#### 1. New Features |
163 | | - |
164 | | -- New endpoints in the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v1.39 have been added. |
165 | | - - Fault Injection Service (FIS) |
166 | | - - Marketplace Metering |
167 | | - - Amazon Transcribe |
168 | | - - Amazon MQ |
169 | | - |
170 | | -#### 2. General |
171 | | - |
172 | | -- .NET 7 support added |
173 | | -- .NET 5 ve .NET Core 3.1 runtimes removed from Nuget pack (.netstandard2.0 remains) |
174 | | -- Tested against LocalStack v1.3.1 container. |
175 | | -- AWSSDK.Core set to 3.7.103 as the minimum version. |
176 | | - - **Warning** In this version, the ServiceURL property of Amazon.Runtime.ClientConfig adds a trailing `/` to every URL set. |
177 | | - For example, if `http://localhost:1234` is set as the value, it will become `http://localhost:1234/` |
178 | | -- Following depedencies updated from v3.0.0 to v3.1.32 in LocalStack.Client.Extensions for security reasons |
179 | | - - Microsoft.Extensions.Configuration.Abstractions |
180 | | - - Microsoft.Extensions.Configuration.Binder |
181 | | - - Microsoft.Extensions.DependencyInjection.Abstractions |
182 | | - - Microsoft.Extensions.Logging.Abstractions |
183 | | - - Microsoft.Extensions.Options.ConfigurationExtensions |
184 | | - |
185 | | -#### 3. Bug Fixes |
186 | | - |
187 | | -- Write a timestream record using .Net AWSSDK NuGet packages ([#20](https://github.com/localstack-dotnet/localstack-dotnet-client/issues/20)) |
188 | | -- Session does not honor UseSsl and always sets UseHttp to true ([#16](https://github.com/localstack-dotnet/localstack-dotnet-client/issues/16)) |
189 | | - |
190 | | -### [v1.3.1](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.3.1) |
191 | | - |
192 | | -#### 1. New Features |
193 | | - |
194 | | -- New endpoints in the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v1.35 have been added. |
195 | | - - Route53Resolver |
196 | | - - KinesisAnalyticsV2 |
197 | | - - OpenSearch |
198 | | - - Amazon Managed Workflows for Apache Airflow (MWAA) |
199 | | - |
200 | | -#### 2. General |
201 | | - |
202 | | -- Tested against LocalStack v0.14.2 container. |
203 | | -- AWSSDK.Core set to 3.7.9 as the minimum version. |
204 | | -- AWSSDK.Extensions.NETCore.Setup set to 3.7.2 as the minimum version. |
205 | | - |
206 | | -### [v1.3.0](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.3.0) |
207 | | - |
208 | | -#### 1. New Features |
209 | | - |
210 | | -- New endpoints in the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v1.27 have been added. |
211 | | - - SESv2 |
212 | | - - EventBridge ([#14](https://github.com/localstack-dotnet/localstack-dotnet-client/pull/14)) |
213 | | -- Tested against LocalStack v0.13.0 container. |
214 | | - |
215 | | -#### 2. Enhancements |
216 | | - |
217 | | -- `useServiceUrl` parameter added to change client connection behavior. See [useServiceUrl Parameter](#useserviceurl) |
218 | | -- Readme and SourceLink added to Nuget packages |
219 | | - |
220 | | -#### 3. Bug Fixes |
221 | | - |
222 | | -- Session::RegionName configuration does not honor while creating AWS client ([#15](https://github.com/localstack-dotnet/localstack-dotnet-client/issues/15)) |
223 | | - |
224 | | -Thanks to [petertownsend](https://github.com/petertownsend) for his contribution |
225 | | - |
226 | | -### [v1.2.3](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.2.3) |
227 | | - |
228 | | -- New endpoints in the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v1.25 have been added. |
229 | | - - Config Service |
230 | | -- .NET 6.0 support added. |
231 | | -- AWSSDK.Core set to 3.7.3.15 as the minimum version. |
232 | | -- AWSSDK.Extensions.NETCore.Setup set to 3.7.1 as the minimum version. |
233 | | -- Tested against LocalStack v0.13.0 container. |
234 | | - |
235 | | -### [v1.2.2](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.2.2) |
236 | | - |
237 | | -- New endpoints in the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v1.22 have been added. |
238 | | - - EFS, Backup, LakeFormation, WAF, WAF V2 and QLDB Session |
239 | | -- AWSSDK.Core set to 3.7.1 as the minimum version. |
240 | | -- Tested against LocalStack v0.12.16 container. |
241 | | - |
242 | | -### [v1.2](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.2.0) |
243 | | - |
244 | | -- New endpoints in the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v1.20 have been added. |
245 | | - - IoTAnalytics, IoT Events, IoT Events Data, IoT Wireless, IoT Data Plane, IoT Jobs Data Plane, Support, Neptune, DocDB, ServiceDiscovery, ServerlessApplicationRepository, AppConfig, Cost Explorer, MediaConvert, Resource Groups Tagging API, Resource Groups |
246 | | -- AWSSDK.Core set to 3.7.0 as the minimum version. |
247 | | -- Obsolete methods removed. |
248 | | -- New alternate AddAWSServiceLocalStack method added to prevent mix up with AddAWSService (for LocalStack.Client.Extension v1.1.0). |
249 | | -- Tested against LocalStack v0.12.10 container. |
250 | | - |
251 | | -### [v1.1](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.1.0) |
252 | | - |
253 | | -- New endpoints in the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v1.10 have been added. |
254 | | - - Transfer, ACM, CodeCommit, Kinesis Analytics, Amplify, Application Auto Scaling, Kafka, Timestream Query, Timestream Write, Timestream Write, S3 Control, Elastic Load Balancing v2, Redshift Data |
255 | | -- .NET 5.0 support added. |
256 | | -- AWSSDK.Core set to 3.5.0 as the minimum version. |
257 | | -- Tested against LocalStack v0.12.07 container. |
258 | | - |
259 | | -### [v1.0](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v1.0.0) |
260 | | - |
261 | | -- New endpoints in the official [Localstack Python Client](https://github.com/localstack/localstack-python-client) v0.23 have been added. |
262 | | - - ElastiCache, Kms, Emr, Ecs, Eks, XRay, ElasticBeanstalk, AppSync, CloudFront, Athena, Glue, Api Gateway V2, RdsData, SageMaker, SageMakerRuntime, Ecr, Qldb |
263 | | -- .netcore2.2 support removed since Microsoft depracated it. .netcore3.1 support added. |
264 | | -- AWSSDK.Core set to 3.3.106.5 as the minimum version. |
265 | | - |
266 | | -### [v0.8.0.163](https://github.com/localstack-dotnet/localstack-dotnet-client/releases/tag/v0.8.0.163) |
267 | | - |
268 | | -- First release. |
0 commit comments