AzureCommunication 1.0.0-beta.12

AzureCommunication 1.0.0-beta.12

×

由 Microsoft Corporation 维护。

AzureCommunication 1.0.0-beta.12

  • 由
  • Azure SDK 移动团队
此库已弃用，建议您查看 AzureCommunicationCommon。

Azure SDK for iOS

此仓库用于 Azure SDK for iOS 的积极开发。对于 SDK 的消费者，我们建议访问我们的版本化 开发者文档。

注意：Azure SDK for iOS 替代了之前的产品，即 Azure.iOS。Azure.iOS 的源代码和文档在 遗产分支 中可用。

入门

为了方便您，每个服务都有单独的库集，您可以选择使用，而不是一个大型 Azure 包。要开始使用特定库，请参阅位于库项目文件夹中的 README.md 文件。您可以在 /sdk 目录中找到服务库。

先决条件

  • 客户端库是用现代 Swift 5 编写的。因此，需要 Xcode 10.2 或更高版本才能使用这些库。
  • 您必须拥有一个 Azure 订阅 才能使用这些库。

可用的库

SDK的最新版本为 1.0.0-beta.9。也提供了旧的 版本。

目前，客户端库处于 测试版。这些库遵循Azure SDK iOS 设计指南，并共享许多核心功能，例如HTTP重试、日志记录、传输协议、身份验证协议等，因此一旦您学会如何在与一个客户端库中使用这些功能，您就会知道如何在其他客户端库中使用它们。您可以在AzureCore中了解这些共享功能。

以下库目前处于 测试版

核心

Azure 通信服务

注意：SDK目前处于 测试版。API 规面和功能集在此成为广泛应用之前可能随时更改。我们不推荐在生产中使用。

安装库

要安装iOS的Azure客户端库，我们建议您使用Swift包管理器。作为一个替代方案，您也可以使用CocoaPods来集成库。

使用Swift包管理器添加包依赖项

Swift Package Manager 是一个用于管理 Swift 代码分发工具。它与 Swift 构建系统集成，以自动化依赖项的下载、编译和链接过程。

Xcode 内置了对 Swift Package Manager 和源代码控制账户的支持，使得利用现有的 Swift 包变得容易。使用 Xcode 来管理包依赖项的版本，确保您的项目拥有最新代码变更。

Xcode

要将 Azure SDK for iOS 添加到您的应用中，请参考 添加包依赖项到您的应用 中的说明。

在 Xcode 11 或更高版本中打开您的项目，选择 文件 > Swift Packages > 添加包依赖... 输入此存储库的克隆 URL：https://github.com/Azure/azure-sdk-for-ios.git，然后点击 下一步。对于版本规则，指定您希望与您的应用程序一起使用的确切版本或版本范围，然后点击 下一步。最后，为每个您希望与您的应用程序一起使用的客户端库勾选复选框，确保您的应用程序目标在 添加到目标 下拉菜单中选择，然后点击 完成。

Swift CLI

要将 Azure SDK for iOS 添加到您的应用中，请参考 导入依赖项 中的示例。

打开项目的 Package.swift 文件，在项目依赖项部分添加新的包依赖项，指定此存储库的克隆 URL 和您希望使用的版本指定符。

    dependencies: [
        ...
        .package(url: "https://github.com/Azure/azure-sdk-for-ios.git", from: "1.0.0-beta.9")
    ],

接下来，将您希望在每个目标中使用的目标客户端库添加到目标的 dependencies 数组中。

    targets: [
        ...
        .target(
            name: "MyTarget",
            dependencies: ["AzureCommunicationChat", ...])
    ]
)

将客户端库集成到 CocoaPods 中

CocoaPods 是 Objective-C 和 Swift 项目的依赖项管理器。您可以使用以下命令安装它

$ [sudo] gem install cocoapods

CocoaPods 1.5+ 是必需的。

要使用 CocoaPods 在项目中集成一个或多个客户端库，请在您的 Podfile 中指定它们，提供您希望使用的版本指定符。为确保在同一项目中使用多个客户端库时的兼容性，在项目中的所有 Azure SDK 客户端库中使用相同的版本指定符

platform :ios, '12.0'

# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!

target 'MyTarget' do
  pod 'AzureCommunicationChat', '~> 1.0.0-beta.9'
  ...
end

然后，运行以下命令

$ pod install

需要帮助吗？

  • 通过 GitHubIssues 提交问题。
  • 查看 先前问题 或在 StackOverflow 上使用 azure 和 ios 标签提出新问题。

报告安全问题和安全漏洞

安全问题和漏洞应通过电子邮件私下报告给微软安全响应中心（MSRC）[email protected]。您应该在 24 小时内收到回复。如果您出于某种原因没有收到，请通过电子邮件跟进以确保我们已经收到了您原始的消息。更多信息，包括 MSRC PGP 密钥，可在 安全技术中心 找到。

贡献

有关向此存储库贡献的详细信息，请参阅贡献指南。

本项目欢迎贡献和建议。大多数贡献需要您同意一份贡献者许可协议（CLA），声明您有权利，实际上确实授予我们使用您贡献的权利。有关详细信息，请访问https://cla.microsoft.com。

当您提交拉取请求时，CLA 机器人将自动确定您是否需要提供 CLA 并相应地装饰 PR（例如，标签，注释）。只需按照机器人提供的说明操作即可。您只需要在整个使用我们的 CLA 的所有存储库中进行一次。

本项目采用了微软开源行为准则。更多信息请参阅行为准则常见问题或联系[email protected]，提出任何额外的疑问或评论。

Impressions