iOS 无宿主App源码时,真机环境一键调试动态库

背景

合作项目,一方提供宿主App,一方提供动态库。双方囿于合规而不能为对方提供源码,所以双方提供的产物都是二进制产物。
运行时双方融合是没有问题的,但是对开发(尤其是动态库开发方)是不友好的。

当然,这场景要是在其他操作系统是没有什么大问题的。但对于iOS而言,因为苹果的硬性限制,真机环境调试是有些麻烦的。为解决开发阶段的调试需求,本文提供了一种思路并实践可行。

一些准备

  • 开发者证书(调试)是必需的
  • Xcode ,本文成文时使用的是13.4.1
  • fastlane 工具,本文使用其重签名工具

手动调试

在介绍一键调试前,先大致介绍下如何手动调试。
若要在真机环境调试,需要先将部署到真机的所有可执行文件进行签名,这包括App主程序和动态framework

获取开发者证书列表

运行命令,获取可用的证书列表

security find-identity -v -p codesigning

结果一般是十六进制字符串和证书名字,例如

  1) 十六进制串  "Apple Development: xxxxx(yyyyyyy)"
     1 valid identities found

动态库重签名

codesign  -f -s 证书标识(十六进制串)   xxxx.framework

ipa包重签名

本文使用fastlane工具

# 安装fastlane
sudo gem install fastlane

安装成功后,执行重签名

fastlane sigh resign
#然后安装提示输入ipa包文件路径、证书文件路径
#期间也可填写证书的十六进制串

特别注意:重签名证书必需使用开发证书
重签名成功后,获得同名的ipa包,使用Xcode提供的Devices and Simulators工具将ipa包安装到iPhone真机中

附加到进程

在真机上启动App
然后使用Xcode 提供的Debug -> Attach to Process工具,将动态库附加到App进程中,正常情况下是就可以了进行调试了。

一键调试

一键调试的原理和过程和手动调试是类似的,只不过把一些工作自动化了

解压包

将重签名的ipa包解压,获得里面的Payload,找到对应的宿主App(一般名字为xxxxx.app)

创建新动态Target

新建Target不需要侵入其他Target的工程配置。

假设新建Target就叫做DebugiPhoneosTarget,打开DebugiPhoneosTarget的scheme进行编辑
Edit Scheme -> DebugiPhoneosTarget -> Run -> Info -> Executeable -> Other , 选择解压后宿主App

另外,编辑Scheme时,最好去掉最下方的“Share”选项(即不共享这个Scheme配置,避免git仓库管理时频繁发生冲突)

配置好后,直接点击Xcode Run是可以直接启动宿主App。如果能成功启动宿主App,那么一键调试就成功了一半。

配置Build Phase脚本

DebugiPhoneosTargetBuild Phase里面新建一个Run Script Phase,内容为sh $SRCROOT/debug.sh 一些参数或者python $SRCROOT/debug.py 一些参数($SRCROOT是工程目录,一些参数见下文)。当然,你可以使用其他语言类型的脚本,本文使用python脚本。

在debug.py中,主要就做了件事:
1、将Xcode构建生成的动态framework复制到宿主App/Frameworks目录中
2、对新生成的动态framework进行重签名
其实,还可以有第3件事,就是复制图片等资源文件,不过这就看具体的项目工程了。

debug.py中的核心代码

#!/usr/bin/python
# -*- coding: UTF-8 -*-

import sys
import os

CONFIGURATION_BUILD_DIR = sys.argv[1] # 构建产物输出目录
EXPANDED_CODE_SIGN_IDENTITY = sys.argv[2] # 签名证书的十六进制串

# 动态framework路径
frameworkName = xxxxx
frameworkPath  = xxxxxx
# 宿主App的路径
hostAppPath = xxxxxx

# 复制framework
src = os.path.join(frameworkPath, frameworkName)
dst = os.path.jons(hostAppPath,frameworkName ,frameworkName)
func_copy(src,dst) # func_copy自定义的复制函数

#复制Info.plist 特别提醒Info.plist里面的内容必须是framework自己的,否则会影响重签名,导致运行失败
src = os.path.join(frameworkPath, "Info.plist")
dst = os.path.jons(hostAppPath,frameworkName ,"Info.plist")
func_copy(src,dst) # func_copy自定义的复制函数

#重签名
dst = dst = os.path.jons(hostAppPath,frameworkName )
os.system("codesign  -f -s 证书标识(十六进制串)  " + dst)

脚本中CONFIGURATION_BUILD_DIR和EXPANDED_CODE_SIGN_IDENTITY就是上文提到的一些参数,需要主动传入,幸好Xcode 提供了环境变量宏,所以Build Phase脚本内容更新如下:

python  $SRCROOT/debuy.py $CONFIGURATION_BUILD_DIR $EXPANDED_CODE_SIGN_IDENTITY

或者

sh $SRCROOT/debug.sh  $CONFIGURATION_BUILD_DIR $EXPANDED_CODE_SIGN_IDENTITY

好了,再次点击Xcode Run试试

你可能感兴趣的:(炒冷饭,ios)