美文网首页
Jenkins打包iOS App(xcodebuild)

Jenkins打包iOS App(xcodebuild)

作者: JonyTse | 来源:发表于2022-03-25 17:47 被阅读0次

为什么要用xcodebuild 命令行打包？因为不会受到 Jenkins xcode 插件的影响。最近就是因为升级了Jenkins xcode插件，导致所有xcode项目无法打包。

先来看看 xcodebuild 命令是怎样打包和发布 ios 项目的

一 、xcodebuild 打包解析

1、xcodebuild 常用命令

  • xcodebuild -showsdks: 列出 Xcode 所有可用的 SDKs

  • xcodebuild -showBuildSettings

    xcodebuild -showBuildSettings [-project name.xcodeproj | [-workspace name.xcworkspace -scheme schemename]]

    查看当前工程 build setting 的配置参数，Xcode 详细的 build setting 参数参考官方文档 Xcode Build Setting Reference， 已有的配置参数可以在终端中以 buildsetting=value 的形式进行覆盖重新设置

  • xcodebuild -list

    xcodebuild -list [-project name.xcodeproj | -workspace name.xcworkspace]

    查看 project 中的 targets 和 configurations，或者 workspace 中 schemes

2、打开钥匙串访问， 导入证书

security unlock-keychain "-p" password "/Users/***/Library/Keychains/login.keychain-db"

3、清理项目

xcodebuild -workspace ***.xcworkspace -scheme *** -configuration Release clean

4、编译 archive

xcodebuild archive -workspace $project_workspace \
    -scheme $project_scheme \
    -configuration $Configuration \
    PLATFORM_NAME=iphoneos \
    -archivePath $archive_path \
    BUILD_DIR="$build_dir" \
    CODE_SIGN_IDENTITY="$CODE_SIGN_IDENTITY"  \
    PROVISIONING_PROFILE_SPECIFIER="$CPROVISIONING_PROFILE_NAME" \
    PROVISIONING_PROFILE="${PROFILE_UUID}" \
    PRODUCT_BUNDLE_IDENTIFIER="${BUILD_ID}" \
    -quiet

参数解析

  • -workspace 项目的workspace，以 .xcworkspace 命名的文件

  • -scheme 可通过 xcodebuild -list 查询

  • BUILD_DIR 编译输出路径

  • -archivePath acrhive的目标路径，在BUIDL_DIR下

  • CODE_SIGN_IDENTITY 证书名称, 注意可能会包证书错误

    CODE_SIGN_IDENTITY获取方法:

    打开你的钥匙串访问->选中目标证书->右键->显示简介，把标题复制出来就可以了。

  • PROVISIONING_PROFILE_SPECIFIER

    描述文件名 xxx.moileprovision

  • PROVISIONING_PROFILE

    描述文件UUID , 打开xxx.moileprovision 文件，搜索UUID

  • PRODUCT_BUNDLE_IDENTIFIER BUILD_ID com.xxxx.mall

  • -quiet 只输出警告、错误消息

5、以版本号命名 .ipa文件

/usr/libexec/PlistBuddy -c "Print :ApplicationProperties:CFBundleVersion" ${archivePath}/Info.plist
/usr/libexec/PlistBuddy -c "Print :ApplicationProperties:CFBundleShortVersionString" ${archivePath}/Info.plist

6、输出 IPA 包文件

xcodebuild -exportArchive -archivePath $archive_path -exportOptionsPlist $exportOptionsPlist -exportPath $export_path

  • -exportOptionsPlist

    这是必须项，是一个配置文件，里面配置了证书信息什么的。
    XCode9以后如果使用命令打包，就需要有这个配置文件。
    创建ExportOptions.plist的方式有两种：
    1 、XCode执行发布，生产ipa同时会同时生成这个文件。
    2、 也可以手动创建ExportOptions.plist，然后加入相关键值对。

    OptionExport.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">
<plist version="1.0">
<dict>
        <key>signingStyle</key>
        <string>manual</string>
        <key>method</key>
        <string>development</string>
        <key>signingCertificate</key>
        <string>iOS Developer</string>
        <key>provisioningProfiles</key>
        <dict>
                <key>'${BundleID}'</key>
                <string>'${PROFILE_UUID}'</string>
        </dict>
        <key>iCloudContainerEnvironment</key>
        <string>Development</string>
        <key>stripSwiftSymbols</key>
        <key>teamID</key>
      <string>XXXXXXXXX</string>
        <true/>
        <key>compileBitcode</key>
        <true/>
</dict>
</plist>

    OptionExport.plist各字段说明

    method： 字符串，为打包的类型，分为app-store，ad-hoc，enterprise和development，根据自己实际打包情况填写。
    provisioningProfiles： 字典，Xcode9需要，键值对为{bundleid：证书标识 Identifiers }，{PROFILE_UUID：描述文件名对应的UUID。}
    signingCertificate： 证书类型，开发环境为iPhone Developer，生产环境为iPhone Distribution。
    signingStyle： 自动还是手动（manual与automatic），填写manual即可。
    stripSwiftSymbols： 填写为YES。
    teamID： 为开团队ID，在钥匙串中点击证书详情可以查看到。
    uploadBitcode： 为YES即可。
    uploadSymbols： 为YES即可。

！错误解决

error: Missing private key for signing certificate. Failed to locate the private key matching certificate "Apple Development: *********" in the keychain. To sign with this signing certificate, install its private key in your keychain. If you don't have the private key, select a different signing certificate for CODE_SIGN_IDENTITY in the build settings editor. (in target 'ALWMallGuideDevelop' from project 'ALWMallGuide')

删除 CODE_SIGN_IDENTITY="$CODE_SIGN_IDENTITY" 参数即可

二、 jenkins配置范例

需要的插件

git，emall, Inject environment variables(环境变量注入)

1、仓库配置

image-20210603112044481.png

2、构建脚本

先添加 shell 将变量写入文件

# 打包的环境，正式环境为空，可选 {'Develop';  'Release';  ''}
APP_ENV="Develop"

#工程名字(Target名字)
Project_Name="ALWMallGuide"


# build 路径
project_workspace="${Project_Name}.xcworkspace"
project_scheme="${Project_Name}${APP_ENV}"

# 获取app版本号
APP_VERSION=`/usr/libexec/PlistBuddy -c "Print :CFBundleShortVersionString" "${WORKSPACE}/ALWMallGuide/Resources/${project_scheme}-Info.plist"`

export_path="/Users/admin/project/build/${Project_Name}"
export_name="${export_path}/${project_scheme}_${APP_VERSION}.ipa"

# archive 目标路径
build_dir="${WORKSPACE}/build"
archive_path="${build_dir}/${project_scheme}.xcarchive"

#plist文件
exportOptionsPlist="${build_dir}/${project_scheme}.plist"


# 构建变量写入文件
echo "APP_VERSION=${APP_VERSION}
project_workspace=${project_workspace}
project_scheme=${project_scheme}
export_path=${export_path}
export_name=${export_name}
build_dir=${build_dir}
archive_path=${archive_path}
exportOptionsPlist=${exportOptionsPlist}" > BuildVariable

添加环境变量注入

image-20210603112408495.png 
# 打包的环境，正式环境为空，可选 {'Develop';  'Release';  ''}
APP_ENV=Develop

#配置环境，Release或者Debug
Configuration=Release

#AdHoc版本的Bundle ID
BundleID=com.xxxx.mall

#证书名#描述文件
CODE_SIGN_IDENTITY=Apple Development: **************
CPROVISIONING_PROFILE_NAME=***********Mall_dep
PROFILE_UUID=9f4b27dc-f3f7-45e3-bb0c-816c7586560f

添加打包脚本（Execute shell）

#!/bin/bash

#author Jony

func_export_plist(){
echo '<?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">
<plist version="1.0">
<dict>
        <key>signingStyle</key>
        <string>manual</string>
        <key>method</key>
        <string>development</string>
        <key>signingCertificate</key>
        <string>iOS Developer</string>
        <key>provisioningProfiles</key>
        <dict>
                <key>'${BundleID}'</key>
                <string>'${PROFILE_UUID}'</string>
        </dict>
        <key>iCloudContainerEnvironment</key>
        <string>Development</string>
        <key>stripSwiftSymbols</key>
        <true/>
        <key>compileBitcode</key>
        <true/>
</dict>
</plist>' > ${exportOptionsPlist}
}
 
func_build(){
    # 证书解锁
    security unlock-keychain -p 123456 ~/Library/Keychains/login.keychain-db
    # 清理
    xcodebuild clean -workspace $project_workspace -scheme $project_scheme -configuration $Configuration
    # 构建 archive 包
    xcodebuild archive -workspace $project_workspace \
    -scheme $project_scheme \
    -configuration $Configuration \
    PLATFORM_NAME=iphoneos \
    -archivePath $archive_path \
    BUILD_DIR="$build_dir"  \
    PROVISIONING_PROFILE_SPECIFIER="$CPROVISIONING_PROFILE_NAME" \
    PROVISIONING_PROFILE="${PROFILE_UUID}" \
    PRODUCT_BUNDLE_IDENTIFIER="${BundleID}" -quiet
    # 输出版本号
    /usr/libexec/PlistBuddy -c "Print :ApplicationProperties:CFBundleVersion" ${archivePath}/Info.plist
    /usr/libexec/PlistBuddy -c "Print :ApplicationProperties:CFBundleShortVersionString" ${archivePath}/Info.plist
    #输出ipa包
    xcodebuild -exportArchive -archivePath $archive_path -exportOptionsPlist $exportOptionsPlist -exportPath $export_path
}

cd ${WORKSPACE}
mkdir -p build
# 编译
func_export_plist
func_build

添加发布脚本

# 生成download.plist文件
echo '<?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">
<plist version="1.0">
<dict>
    <key>items</key>
    <array>
        <dict>
            <key>assets</key>
            <array>
                <dict>
                    <key>kind</key>
                    <string>software-package</string>
                    <key>url</key>
                    <string>${url}/mallguide/'${project_scheme}'_'${APP_VERSION}'.ipa</string>
                </dict>
                <dict>
                    <key>kind</key>
                    <string>display-image</string>
                    <key>url</key>
                    <string>${url}/mallguide/image.57x57.png</string>
                </dict>
                <dict>
                    <key>kind</key>
                    <string>full-size-image</string>
                    <key>url</key>
                    <string>${url}/mallguide/image.512x512.jpg</string>
                </dict>
            </array>
            <key>metadata</key>
            <dict>
                <key>bundle-identifier</key>
                <string>com.xxxx.mall</string>
                <key>bundle-version</key>
                <string>'${APP_VERSION}'</string>
                <key>kind</key>
                <string>software</string>
                <key>title</key>
                <string>App名称</string>
            </dict>
        </dict>
    </array>
</dict>
</plist>' > ${export_path}/${project_scheme}_${APP_VERSION}_Download.plist

mv ${export_path}/${project_scheme}.ipa ${export_name}

最后添加邮件发送

相关文章

网友评论

      本文标题：Jenkins打包iOS App(xcodebuild)

      本文链接：https://www.haomeiwen.com/subject/fbsdjrtx.html

      延伸阅读

      深度阅读

      • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

      栏目导航

      热点阅读

      关于我们|服务条款|联系我们|Jenkins打包iOS App(xcodebuild)|投稿指南|网站地图|RSS订阅|排版工具|手机版

      提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

      Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

      备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

      本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

      所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！