Skip to content

Latest commit

 

History

History
34 lines (20 loc) · 2.64 KB

AzureSDKCodeGeneration_DataPlane_Quickstart.md

File metadata and controls

34 lines (20 loc) · 2.64 KB
Raw

Azure SDK Code Generation Quickstart Tutorial (Data Plane)

We build Azure SDK libraries to give developers a consistent, unified experience working with Azure services, in the language ecosystem where they're most comfortable. Azure SDK Code Generation allows you to quickly and easily create a client library so customers can work with your service as part of the SDK. In this tutorial, we will step through the process of creating a new Azure SDK Generated Client library for a data plane Azure service. The output library will have an API that follows .NET Azure SDK Design Guidelines, which will give it the same look and feel of other .NET libraries in the Azure SDK.

Azure SDK Code Generation takes a TypeSpec as input and uses the autorest.csharp generator to output a generated library. It is important that the input TypeSpec files (*.tsp) should comply with TypeSpec lint rules so the output library is consistent with the Azure SDK Guidelines.

Prerequisites

For first time to set up of a new SDK package, please verify you have met the prerequisites, including runtime environment, TypeSpec project, and SDK project folder. You can refer to SDK Generation Prerequisites to set up.

Generate SDK

We will generate an SDK under the SDK project folder of azure-sdk-for-net.

Configuration (optional)

You can update tsp-location.yaml under sdk project folder to set the typespec project.

You can refer to the tsp-location.yaml which describes the supported properties in the file.

Generate Code

Enter src sub-directory of sdk project folder, e.g. /home/azure-sdk-for-net/sdk/anomalyDetector/Azure.AI.AnomalyDetector/src Run dotnet build /t:GenerateCode, and the code will be generated under sdk\<servie name>\<package name>\src\Generated

dotnet build /t:GenerateCode

Now that you have generated your SDK, you can release it by following the following steps:

  1. Create a release plan. It will provide you with a workflow of tasks that you will need to accomplish to release an SDK. For example, all the neccessary approvals, guidance on testing, release pipeline, and more.
  2. Enhance the SDK.