3f3e09e6ac
Sync eng/common directory with azure-sdk-tools repository |
||
---|---|---|
.github | ||
Azure.xcworkspace | ||
AzureAuth | ||
AzureCore | ||
AzureData | ||
AzureData ObjC | ||
AzureMobile | ||
AzurePush | ||
AzureStorage | ||
Example | ||
eng/common | ||
scripts | ||
.gitignore | ||
.travis.yml | ||
AzureAuth.podspec | ||
AzureCore.podspec | ||
AzureData.podspec | ||
AzureMobile.podspec | ||
AzurePush.podspec | ||
AzureStorage.podspec | ||
LICENSE | ||
Package.swift | ||
README.md |
README.md
Azure.iOS
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
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
AzureCore is a shared dependency of the other four SDKs. It includes functionality like secure storage, reachability, logging, etc.
AzureMobile
AzureMobile is an SDK that connects to services deployed using Azure.Mobile.
AzureAuth
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
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
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.