配置
1.域名网站支持https
2.将此apple-app-site-association上传到网站根目录

开启Associated Domains服务
在xcode工程的Capabilities -> Associated Domains中添加跳转域名，域名的格式为：
applinks:www.example.com

universalLink.jpg
服务器必须支持SSL
Domains可以添加多个
Domains必须以applinks: 开头

配置apple-app-site-association文件
{
"applinks": {
"apps": [],
"details": [
{
"appID": "9JA89QQLNQ.com.apple.wwdc",
"paths": ["iosapp/","iosapp/",""]
}
]
}
}
apps项必须对应一个空的数组
details项对应一个字典的数组
appID对应项由前缀和ID两部分组成,可以在developer中的Identifiers→AppIDs中点击对应的App ID查看

paths对应域名中的path，用于过滤可以跳转到App的链接，支持通配符*，?以及NOT进行匹配，匹配的优先级是从左至右依次降低

配置上path，同一公司可能多款app有次需求，不同的path有益于后期的扩展

把配置好的JSON文件上传到服务器中该域名的根目录下，也就是说，我们可以用GET请求可以获取到这个apple-app-association文件。(APP第一次安装，苹果会进服务器下载文件，调试的时候建议删除以后再安装)

Appdelegate增加如下代码

[WXApi registerApp:@"wx_example" universalLink:@"https://www.example.com"];

• (BOOL)application:(UIApplication )application continueUserActivity:(NSUserActivity )userActivity restorationHandler:(void (^)(NSArray<id> * _Nullable))restorationHandler {
  return [WXApi handleOpenUniversalLink:userActivity delegate:self];
  }

cocoapoads1.png
二.用rvm安装ruby环境
注意，当ruby版本低于2.2.2时，安装cocoapods会报错，可通过指令 ruby -v检查当前版本。如果版本低于2.2.2，啥也不要说快更新一下。

输入指令：

rvm install 2.5.1
(如上图中，最新版本就是2.5.1)，然后根据提示按enter键。

安装完成之后输入指令

rvm list
查看ruby版本，看看是否安装成功

三.检查更新RubyGems(Ruby1.9.1 以后的版本自带RubyGems)
RubyGems是一个方便而强大的Ruby程序包管理器，Ruby的第三方插件是用gem方式来管理，非常容易发布和共享，一个简单的命令就可以安装上第三方的扩展库。

建议RubyGems升级到2.6.x以上

查看RubyGems的版本用指令:

gem -v
更新RubyGems的版本指令:

gem update --system
四.检查ruby源并移除
先是检查ruby源，

gem sources -l
出现结果如下:

CURRENT SOURCES

https://rubygems.org/

移除

gem sources --remove https://rubygems.org/
替换添加国内的镜像源，之所以要添加国内的ruby-china源，是因为taobao源已经停止维护了，所以此处替换的是ruby-china源，且尽量确保只有一个。输入指令gem sources --add https://gems.ruby-china.com

指令:

gem sources --add https://gems.ruby-china.com

cocoapoads2.png
五.安装CocoaPods(sudo 表示管理员执行指令，需要输入密码的)
sudo gem install cocoapods
成功后

pod setup
如果遇到pod setup没反应,请参考下面文章

1.如果你同事电脑上有安装好,你其实可以从你同事电脑上拷贝过来,直接放到~/.cocoapods/repos该路径就OK了.
2.如果你身边没有装好的CocoaPods的朋友,可以访问这个链接
https://github.com/CocoaPods/Specs (github所有的第三方开源库的Podspec文件都托管在这里,这也是你pod setup所要下载的).
选择Download ZIP,用你的浏览器或者迅雷什么的下载
解压后为Specs-master

Specs-master改名为master放在 ~/.cocoapods/repos 路径即可.

~/.cocoapods/repos 这个路径是在执行 pod setup生成的,所以电脑无法前往此路径是,建议先pod setup下,然后关闭掉即可生成路径.

首先，检查电脑是否已经安装有环境。

在终端输入命令：java -version。

如果已经安装，则会打印java版本。

image
否则，会说没有安装

如果没有安装Java环境的话，需要去官网下载JAVA JDK（注意是JDK，不是JRE）。在下载前注意勾选上方的 Accept License Agreement。否则，无法下载。

image

2. 安装Jenkins
3. 使用Homebrew的命令行进行安装
   在终端输入命令：brew install jenkins

如果没有安装Homebrew，则需要先安装。

【Homebrew 安装方法】：前往Homebrew官网，直接拷贝官网页面上的命令，在终端运行即可。

2. 启动jenkins，等待其安装完毕。
   在终端输入命令：jenkins

3. 浏览器输入http://localhost:8080并进行访问。

4. 安装插件
   Xcode integration
   GIT plugin
   GitLab Plugin
   Gitlab Hook Plugin
   Keychains and Provisioning Profiles Management

首页的左侧，点击系统管理
在系统管理界面找到插件管理
在管理插件界面，切换到可选插件选项卡，在右上角的过滤搜索里面输入我们要安装的插件名称，回车。找到我们需要的插件，打勾，点击直接安装。

3. 项目新建和设置
   点击首页的创建一个新任务
   选择构建一个自由风格的软件项目。PS：这里的任务名称还是写我们的APP项目名比较好。后面的配置会用到这个任务名称。

image

4. 配置项目
5. General 参数。
   切换到General选项。勾选“丢弃旧的构建”。

设置包（即构建）的保留天数，以及最大保留个数。这个主要按照需要做设置

“丢弃旧的构建”不勾选也可以。

image

2. 源码管理
   切换到源码管理选项。

输入我们要打包的项目的Git地址。最好SSH的。

填写我们要打包的分支（branch）。

点击Add按钮，Add按钮会弹出一个按钮Jenkins，点击它，进行添加SSH key

image

3. 构建触发器
   切换到“构建触发器”选项。

这里只设置最常用的Poll SCM。切换到“构建触发器”，勾选“Poll SCM”。

H/20 表示：每20分支构建一次。

image

4. 构建环境

image

image

5. Excute shell
   切换到“构建”选项

勾选“增加构建步骤”里面的Excute shell。

添加命令到Comman上。

image
打包

!/bin/bash -l

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

pod install --verbose --no-repo-update

打包环境

config="Release"

config="Debug"

构建

!/bin/bash -l

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

pod install --verbose --no-repo-update

打包环境 (核心)

config="Release"

config="Debug"

构建

xcodebuild -archivePath "/Users/(用户名)/.jenkins/workspace/iOS-lighthouse-ci_beta/build/Debug-iphoneos/(项目名称).xcarchive" -workspace (项目名称).xcworkspace -sdk iphoneos -scheme "(项目名称)" -configuration ${config} archive

xcodebuild -exportArchive -archivePath "/Users/(用户名)/.jenkins/workspace/iOS-lighthouse-ci_beta/build/Debug-iphoneos/(项目名称).xcarchive" -configuration ${config} -exportPath "/Users/(用户名)/.jenkins/workspace/iOS-lighthouse-ci_beta/build/(项目名称)_debug" -exportOptionsPlist '/Users/(用户名)/.jenkins/workspace/iOS-lighthouse-ci_beta/build/ExportOptions.plist' -allowProvisioningUpdates

上传至蒲公英平台

通过api上传到蒲公英当中

echo "===上传至蒲公英平台==="

蒲公英userkey

pgyerUserKey="userkey"

蒲公英apiKey

pgyerApiKey="apiKey"

指定ipa输出地址

project_path=$(pwd)

指定项目名

project_name="项目名"

描述信息

des=cat ci-beta-description.txt
echo "des:+$des"
packageTime="打包时间：【date \"+%Y-%m-%d %H:%M:%S\"】---"
echo $packageTime

ipa_path="${project_path}/build/(项目名称)_debug"

if [ -e ${ipa_path}/${project_name}.ipa ]; then

RESULT=$(curl -F "_api_key=${pgyerApiKey}" \
-F "file=@${ipa_path}/${project_name}.ipa" \
-F "buildInstallType=2" \
-F "buildPassword=1230" \
-F "buildUpdateDescription=${packageTime}${des}" \
https://www.pgyer.com/apiv2/app/upload)

# echo ${RESULT}
if [ "${RESULT}" ]; then
    echo "===完成蒲公英平台上传==="
else
    echo "===上传蒲公英平台失败==="
fi
# open ${ipa_path}

else
echo "===上传蒲公英平台失败==="
fi

5. Keychains and Provisioning Profiles Management
   login.keychain 文件路径 /Users/(用户名)/Library/Keychains

image

image
问题
error: Couldn't load -exportOptionsPlist: The file “ExportOptions.plist” couldn’t be opened because there is no such file.
Error Domain=NSCocoaErrorDomain Code=260 "The file “ExportOptions.plist” couldn’t be opened because there is no such file." UserInfo={NSFilePath=/Users/ageren/.jenkins/workspace/Vol_Chat/build/ExportOptions.plist, NSUnderlyingError=0x7fb479178710 {Error Domain=NSPOSIXErrorDomain Code=2 "No such file or directory"}}
解决

在/Users/(用户名)/.jenkins/workspace/(项目名称)/build/路径新建ExportOptions.plist文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

• (void)viewWillAppear:(BOOL)animated {
  [super viewWillAppear:animated];

  [self.navigationController setNavigationBarHidden:YES animated:YES];
  }

• (void)viewWillDisappear:(BOOL)animated {
  [super viewWillDisappear:animated];

  [self.navigationController setNavigationBarHidden:NO animated:YES];
  }
  第二种做法
  设置self为导航控制器的代理,实现代理方法,在将要显示控制器中设置导航栏隐藏和显示,使用这种方式不仅完美切合滑动返回手势,同时也解决了切换tabBar的时候,导航栏动态隐藏的问题.

• (void)viewDidLoad {
  [super viewDidLoad];

  // 设置导航控制器的代理为self
  self.navigationController.delegate = self;
  }

pragma mark - UINavigationControllerDelegate

// 将要显示控制器

• (void)navigationController:(UINavigationController )navigationController willShowViewController:(UIViewController )viewController animated:(BOOL)animated {
  // 判断要显示的控制器是否是自己
  BOOL isShowHomePage = [viewController isKindOfClass:[self class]];

  [self.navigationController setNavigationBarHidden:isShowHomePage animated:YES];
  }