Layer iOS 发布
此仓库包含了 Layer公司发布的iOS产品二进制发行版。
如果您对通过此仓库分发的产品有任何问题、评论或问题,请通过电子邮件[email protected]联系我们的团队。有关定价或产品路线图的问题,请通过电子邮件[email protected]来联系。
LayerKit
LayerKit 是用于与 Layer 通信云交互的 iOS SDK。它提供了一个简单、面向对象的接口,用于访问平台提供的丰富消息功能。
要使用 LayerKit,您必须是注册的开发者,拥有配置的应用程序标识符,并已配置了一个后端系统作为您客户端应用的身份提供商。有关此设置的各个方面都在Layer iOS 文档中进行了详细说明。
安装
LayerKit 可以通过导入框架或通过 CocoaPods 直接安装到您的应用程序中。以下是快速安装说明,但请参阅Layer iOS 文档了解所有详细信息以及故障排除。
安装CocoaPods
推荐安装路径为 CocoaPods。CocoaPods提供了一种简单的、按版本管理的依赖关系管理系统,可以自动化手动配置库和框架中的繁琐和容易出错的部分。您可以通过以下方式通过CocoaPods将LayerKit添加到您的项目中:
$ sudo gem install cocoapods
$ pod setup
现在在项目目录的根目录下创建一个Podfile
并添加以下内容:
pod 'LayerKit'
通过以下命令完成安装:
$ pod install
这些说明将设置您的本地CocoaPods环境并将LayerKit导入到您的项目中。完成后,请参考以下“验证LayerKit配置”部分来测试您的安装。
安装Carthage
LayerKit也可以通过Carthage安装到您的项目中。Carthage是一个设计得尽可能简单的分布式包管理器。Carthage不会对您的项目进行任何修改,因此安装过程比CocoaPods稍微复杂一些。要开始使用,请确保您已经安装了Carthage,然后创建一个包含以下内容的Cartfile
:
binary "https://raw.githubusercontent.com/layerhq/releases-ios/master/LayerKit.json"
并运行以下命令:
carthage update
这会将LayerKit.framework
放入your_project_root/Carthage/Build/iOS/
目录中,您可以从中将其添加到项目中并将其与应用目标链接。然后在XCode中选择您的应用目标,并转到构建阶段面板,点击+
图标并选择新运行脚本阶段。设置内容如下:
/usr/local/bin/carthage copy-frameworks
在输入文件部分添加
$(SRCROOT)/Carthage/Build/iOS/LayerKit.framework
现在构建您的应用目标,所有设置都应该设置好了。
框架安装
如果您希望建立一个可以在应用中直接安装的LayerKit二进制框架,那么您有两个选择:
LayerKit.framework
- 这是一个动态框架,与针对iOS 8和更高版本的Objective-C和Swift项目兼容。LayerKit.embeddedframework
- 这是一个伪框架,包含一个静态库资产和一组公共头文件。它与针对iOS 7和更高版本的Objective-C项目兼容。
从该存储库中下载适当的构建工件并将其添加到您的应用中
- 将框架拖放到您的项目中,指导Xcode将项目复制到目标组的文件夹中。
- 更新您的项目设置,包括链接器标志:
-ObjC -lz
- 请将以下Cocoa SDK框架添加到您的项目中:
'CFNetwork', 'Security', 'MobileCoreServices', 'SystemConfiguration', 'libsqlite3.tbd'
- 仅LayerKit.framework:动态框架分发需要配置额外的构建阶段以完成安装。具体步骤请参阅Layer知识库。
构建并运行您的项目以验证安装是否成功。成功构建后,请参阅下面的验证LayerKit配置部分,了解如何测试您的设置。
验证LayerKit配置
完成通过CocoaPods或框架安装LayerKit后,您可以通过导入头文件并将客户端连接到Layer云来测试您的配置。要这样做,请编辑您的应用程序代理以包含以下代码(请注意,您必须将应用程序标识符占位符文本替换为您实际的应用程序标识符)
#import <LayerKit/LayerKit.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
NSURL *appID = [NSURL URLWithString:@"INSERT-APPID-URL-HERE"];
LYRClient *layerClient = [LYRClient clientWithAppID:appID];
[layerClient connectWithCompletion:^(BOOL success, NSError *error) {
if (success) {
NSLog(@"Sucessfully connected to Layer!");
} else {
NSLog(@"Failed connection to Layer with error: %@", error);
}
}];
}
启动您的应用程序并验证连接是否成功。您现在可以开始对客户端进行身份验证并发送消息。请参阅Layer iOS文档以获取详细信息。
联系
您可以通过发送电子邮件至[email protected]联系Layer团队。
许可
LayerKit遵循Layer SDK许可。