<commit_before># iOS SDK 集成指南

<style>
img[alt=jpush_ios] { width: 800px; }
</style>

## SDK 说明

### 适用版本

本文匹配的 SDK 版本：r2.1.5 以后。
[查看最近更新](../../updates)了解最新的 SDK 更新情况。
使用 Xcode 6 及以上版本可以使用新版 Push SDK，Xcode 5 环境下需要运行旧版本 SDK（1.7.4）


### 资源文件

包名为 JPush-iOS-SDK-{版本号}

* lib 文件夹：包含头文件 JPUSHService.h，静态库文件 jpush-ios-x.x.x.a，jcore-ios-x.x.x.a（请注意：模拟器不支持 APNs）
    * jcore-ios-1.x.x.a 支持的 iOS 版本为 6.0 及以上版本
    * jcore-ios-2.x.x.a 支持的 iOS 版本为 7.0 及以上版本
* lib-noidfa 文件夹：包含头文件 JPUSHService.h，静态库文件 jpush-noidfa-ios-x.x.x.a，jcore-ios-x.x.x.a（请注意：模拟器不支持 APNs）
    * jcore-ios-1.x.x.a 支持的 iOS 版本为 6.0 及以上版本
    * jcore-ios-2.x.x.a 支持的 iOS 版本为 7.0 及以上版本
* README 文件：SDK 相关说明
* demo 文件夹：示例

###IDFA
从JPUSH3.2.2版本开始，极光提供 idfa 和 noidfa 两个版本。 idfa 版本是标准版，默认自动采集 IDFA 数据， noidfa 版本不自动采集。极光建议开发者使 idfa 版本。当然，如果开发者不想使⽤IDFA 或者担忧采集 IDFA 而未集成任何广告服务遭到 Apple 拒绝，请使用 noidfa 版本。

## 创建应用
* 在 JPush 的管理 Portal 上创建应用，创建成功后自动生成 AppKey 用以标识该应用。

* 在推送设置 iOS 模块上传 APNs 证书或配置 Token Authentication。如果对 APNs 证书不太了解 请参考： [iOS 证书设置指南](ios_cer_guide)

* 详细图示见入门指南 》控制台使用指南 》[创建应用](https://docs.jiguang.cn/jpush/console/Instructions/#_1)



## 配置工程
### 导入 SDK
**选择 1：Cocoapods 导入**

* 通过 Cocoapods 下载地址：

	**1. 如果使用标准版本(需要特别注意以下“注意事项”)**
	
	```
	pod 'JPush'
	```
	```
	注：如果无法导入最新版本，请执行 pod repo update master 这个命令来升级本机的 pod 库，然后重新 pod 'JPush'
	```<commit_msg>fix bug<commit_after># iOS SDK 集成指南

<style>
img[alt=jpush_ios] { width: 800px; }
</style>

## SDK 说明

### 适用版本

本文匹配的 SDK 版本：r2.1.5 以后。
[查看最近更新](../../updates)了解最新的 SDK 更新情况。
使用 Xcode 6 及以上版本可以使用新版 Push SDK，Xcode 5 环境下需要运行旧版本 SDK（1.7.4）


### 资源文件

包名为 JPush-iOS-SDK-{版本号}

* lib 文件夹：包含头文件 JPUSHService.h，静态库文件 jpush-ios-x.x.x.a，jcore-ios-x.x.x.a（请注意：模拟器不支持 APNs）
    * jcore-ios-1.x.x.a 支持的 iOS 版本为 6.0 及以上版本
    * jcore-ios-2.x.x.a 支持的 iOS 版本为 7.0 及以上版本
* lib-noidfa 文件夹：包含头文件 JPUSHService.h，静态库文件 jpush-noidfa-ios-x.x.x.a，jcore-ios-x.x.x.a（请注意：模拟器不支持 APNs）
    * jcore-ios-1.x.x.a 支持的 iOS 版本为 6.0 及以上版本
    * jcore-ios-2.x.x.a 支持的 iOS 版本为 7.0 及以上版本
* README 文件：SDK 相关说明
* demo 文件夹：示例

### IDFA
从JPUSH3.2.2版本开始，极光提供 idfa 和 noidfa 两个版本。 idfa 版本是标准版，默认自动采集 IDFA 数据， noidfa 版本不自动采集。极光建议开发者使 idfa 版本。当然，如果开发者不想使⽤ IDFA 或者担忧采集 IDFA 而未集成任何广告服务遭到 Apple 拒绝，请使用 noidfa 版本。

## 创建应用
* 在 JPush 的管理 Portal 上创建应用，创建成功后自动生成 AppKey 用以标识该应用。

* 在推送设置 iOS 模块上传 APNs 证书或配置 Token Authentication。如果对 APNs 证书不太了解 请参考： [iOS 证书设置指南](ios_cer_guide)

* 详细图示见入门指南 》控制台使用指南 》[创建应用](https://docs.jiguang.cn/jpush/console/Instructions/#_1)



## 配置工程
### 导入 SDK
**选择 1：Cocoapods 导入**

* 通过 Cocoapods 下载地址：

	**1. 如果使用标准版本(需要特别注意以下“注意事项”)**
	
	```
	pod 'JPush'
	```
	```
	注：如果无法导入最新版本，请执行 pod repo update master 这个命令来升级本机的 pod 库，然后重新 pod 'JPush'
	```
{'fraction_non_alphanumeric': 0.15396226415094338, 'fraction_numerical': 0.02188679245283019, 'mean_word_length': 3.7851985559566788, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5984792', 'n_tokens_mistral': 1882, 'n_tokens_neox': 1985, 'n_words': 276}