azure-sdk-for-cpp/sdk/storage/azure-storage-common
JinmingHu c2834b3ff4
Define CMakeTestOptions in Storage's ci.yml file (#4781)
* Define CMakeTestOptions in Storage's ci.yml file

* Update vcpkg.json

---------

Co-authored-by: Anton Kolesnyk <41349689+antkmsft@users.noreply.github.com>
2023-07-15 11:43:54 +08:00
..
inc Use standard syntax for MIT license (#4786) 2023-07-12 22:37:36 -07:00
src Use standard syntax for MIT license (#4786) 2023-07-12 22:37:36 -07:00
test/ut Use standard syntax for MIT license (#4786) 2023-07-12 22:37:36 -07:00
vcpkg Use standard syntax for MIT license (#4786) 2023-07-12 22:37:36 -07:00
cgmanifest.json Add $schema to cgmanifest.json (#3918) 2022-09-13 08:50:38 -07:00
CHANGELOG.md Increment version for storage releases (#4783) 2023-07-12 12:39:58 -07:00
CMakeLists.txt Define CMakeTestOptions in Storage's ci.yml file (#4781) 2023-07-15 11:43:54 +08:00
NOTICE.txt remove amalgamate form CGManifest (#3467) 2022-03-28 11:22:17 +08:00
README.md update storage README (#4183) 2023-02-03 13:50:28 +08:00
vcpkg.json Storage July GA Release (#4757) 2023-07-11 10:18:12 +08:00

Azure Storage Common Client Library for C++

Azure Storage is a Microsoft-managed service providing cloud storage that is highly available, secure, durable, scalable, and redundant. Azure Storage includes Azure Blobs (objects), Azure Data Lake Storage Gen2, Azure Files, and Azure Queues. The Azure Storage Common library provides infrastructure shared by the other Azure Storage client libraries.

Getting Started

Install the package

The easiest way to acquire the C++ SDK is leveraging vcpkg package manager. See the corresponding Azure SDK for C++ readme section.

To install Azure Storage packages via vcpkg:

vcpkg install azure-storage-common-cpp

Then, use in your CMake file:

find_package(azure-storage-common-cpp CONFIG REQUIRED)
target_link_libraries(<your project name> PRIVATE Azure::azure-storage-common)

Prerequisites

You need an Azure subscription and a Storage Account to use this package.

To create a new Storage Account, you can use the Azure Portal, Azure PowerShell, or the Azure CLI.

Build from Source

First, download the repository to your local folder:

git clone https://github.com/Azure/azure-sdk-for-cpp.git

Create a new folder under the root directory of local cloned repo, switch into this folder and run below commands:

Windows:

cmake .. -A x64
cmake --build . --target azure-storage-common

or Unix:

cmake .. -DCMAKE_BUILD_TYPE=Debug
cmake --build . --target azure-storage-common

Key concepts

The Azure Storage Common client library contains shared infrastructure like authentication credentials and exception types.

Contributing

See the Storage CONTRIBUTING.md for details on building, testing, and contributing to these libraries.

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit cla.microsoft.com.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.