azure-sdk-for-ios/README.md

5.8 KiB

Azure.iOS Build Status Carthage compatible CocoaPod Platforms

Azure.iOS is a collection of SDKs for rapidly creating iOS apps with modern, highly-scalable backends on Azure.

This project is in active development and will change.

SDKs

AzureData

Current State: Preview Release

AzureData is an SDK for interfacing with Azure Cosmos DB - A schema-less JSON database engine with rich SQL querying capabilities. It currently supports the full SQL (DocumentDB) API, and offline persistence (including read/write).

AzureCore

Current State: Preview Release

AzureCore is a shared dependency of the other four SDKs. It includes functionality like secure storage, reachability, logging, etc.

AzureMobile

Current State: Development

AzureMobile is an SDK that connects to services deployed using Azure.Mobile.

AzureAuth

Current State: Development

AzureAuth is an SDK that enables authentication with popular identity providers' SDKs to be used to securely access backend services on Azure App Service. It supports five identity providers out of the box: Azure Active Directory, Facebook, Google, Microsoft Account, and Twitter.

AzurePush

Current State: Development

AzurePush will provide push notification functionality. The current SDK for Azure Notification Hubs can be found here. The intent is to migrate that SDK to this repository, update it, and refactor the API to ensure it works seamlessly with the other SDKs in this project to provide the best possible developer experience.

AzureStorage

Current State: Requirements

AzureStorage will provide cloud storage functionality. The current SDK for Azure Storage can be found here. The intent is to migrate that SDK to this repository, update it, and refactor the API to ensure it works seamlessly with the other SDKs in this project to provide the best possible developer experience.

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

[sudo] gem install cocoapods

CocoaPods 1.3+ is required.

To integrate the Azure.iOS into your project, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '12.0'
use_frameworks!

# pod 'AzureAuth', '~> 0.3'
pod 'AzureData', '~> 0.3'

Then, run the following command:

$ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Azure.iOS into your Xcode project using Carthage, specify it in your Cartfile:

github "Azure/Azure.iOS" ~> 0.3

Run carthage update to build the framework and drag the built AzureData.framework, AzureData.framework, etc. into your Xcode project.

Getting Started

Once you add the SDKs to your project...

// coming soon

About

This project is in active development and will change. As the SDKs become ready for use, they will be versioned and released.

We will do our best to conduct all development openly by posting detailed requirements and managing the project using issues, milestones, and projects.

Contributing

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.

Reporting Security Issues

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

License

Copyright (c) Microsoft Corporation. All rights reserved.
Licensed under the MIT License. See LICENSE for details.