theos簡介

theos是一個越獄開發(fā)包,下載安裝簡單，Logos語法簡單，編譯發(fā)布簡單,另一個越獄工具iOSOpenDev被整合到了Xcode中，Theos并未整合到Xcode中.

theos安裝

• 指定xcode
  如果Mac上有安裝多個版本的Xcode，則需要使用xcode-select命令指定一個活動Xcode

//查看xcode SDK版本
xcodebuild -showsdks
//xcode的版本信息
xcodebuild -version
//打印目前使用我的工具Xcode的版本
xcode-select --print-path
//指定xcode
sudo xcode-select -switch /Applications/Xcode5.1.1/Xcode.app

• 安裝dpkg和LDID
  dpkg是Theos依賴的工具之一，dpkg是Debian Packager的縮寫。我們可以使用dpkg來制作deb，Theos開發(fā)的插件都將會以deb的格式進行發(fā)布的。所以我在安裝Theos之前要安裝dpkg, 當然此處我們使用強大的brew來完成dpkg的安裝。
  LDID是越獄祖師爺Saurik公司開發(fā)的一款二進制授權管理軟件，可以對越獄應用進行SHA1運算生成授權，讓軟件包可以在iPhone上執(zhí)行。在Theos開發(fā)插件中，iOS文件的簽名是使用ldid工具來完成的，也就是說ldid取代了Xcode自帶的Codesign。
  brew install dpkg ldid
• 安裝theos

cd  /usr/local/opt/
sudo git clone --recursive https://github.com/theos/theos.git theos 
cd ~
//如果沒有./bash_profile文件,那么就用vim編輯來創(chuàng)建一個 
//命令來創(chuàng)建,并且用編輯模式在里面添加兩行
sudo vim .bash_profile 
export THEOS=/usr/local/opt/theos 
export PATH=/usr/local /opt/theos/bin/:$PATH
//測試是否安裝成功
nic.pl

tweak創(chuàng)建、編譯、打包與安裝

分下面四步：
（1）nic.pl創(chuàng)建

配置好theos后，選擇iphone/tweak
Project Name (required): 工程名稱
Package Name [com.yourcompany.firsttweak]: deb包的名字（類似于bundle identifier)                     
Author/Maintainer Name [zl]: 作者
[iphone/tweak] MobileSubstrate Bundle filter [com.apple.springboard]: tweak作用對象的bundle identifier
[iphone/tweak] List of applications to terminate upon installation (space-separated, '-' for none) [SpringBoard]:tweak安裝完成后需要重啟的應用

創(chuàng)建后會在文件夾內(nèi)默認生成四個文件

• Makefile

Makefile文件指定工程用到的文件、框架、庫等信息，將整個過程自動化。其內(nèi)容說明如下（NIC表示項目名稱）

include $(THEOS)/makefiles/common.mk 
#固定寫法，不要更改。TWEAK_NAME = NIC #Tweak名稱跟control文件中的”Name“字段對應，一般不要更改（但我注意到，在創(chuàng)建Tweak的時候并沒有提示要輸入Project Name就默認生成了NIC）。

NIC_FILES = Tweak.xm 
#Tweak包含的源文件（不包括頭文件），多個文件間以空格分隔，可以按需要更改。

export ARCHS = armv7 arm64 
#默認文件未提供。支持的處理器架構(gòu)，多個以空格分隔。需要注意的是，采用arm64架構(gòu)的App不兼容armv7/armv7s架構(gòu)，必須適配arm64架構(gòu)的dylib。在絕大多數(shù)情況下，這里固定填寫”arm7 arm64“就可以了。

TARGET = iphone:Base SDK:Deployment Target 
#指定SDK版本。如：iphone:8.1:8.0表示指定彩8.1版本的SDK，且發(fā)布對象為iOS8.0及以上版本。也可以把”Base SDK“設置為”latest“，指定以Xcode附帶的最新版本SDK編譯。

export NIC_FRAMEWORKS = framework name 
#默認文件未提供。導入framework。如：NIC_FRAMEWORKS = UIKit CoreAudio

export NIC_PRIVATE_FRAMEWORKS = private framework name
#默認文件未提供。導入private framework。如：NIC_FRAMEWORKS = AppSupport ChatKit。需要注意的是：在導入之前一定要確定導入的private framework確實存在，因為private framework是AppStore開發(fā)所不允許使用的，它的內(nèi)容在每個iOS版本之間可能發(fā)生變化。如：BaseBoard框架在iOS8以上存在，在iOS7就沒有。這種情況通過弱鏈接或dlopen()、dlsym()和dlclose()系列函數(shù)動態(tài)調(diào)用private framework來解決。

export NIC_LDFLAGS = -lx 
#默認文件未提供。鏈接Mach-O對象。Theos采用GNU Linker來鏈接Mack-O對象，包括.dylib、.a和.o。-lx代表鏈接libx.a或libx.dylib，即給”x“加上”lib“的前綴，以及“.a”或“.dylib”的后綴；如果x是“y.o”的形式，則直接鏈接y.o，不加任何前綴或后綴。如要鏈接libsqlite3.0.dylib、libz.dylib和dylib1.o，這樣寫就行：NIC_LDFLAGS = -lz -lsqlite3.0 -dylib1.o

include $(THEOS_MAKE_PATH)/tweak.mk 
#根據(jù)不同的Theos工程類型，指定不同的.mk文件。可以按需更改。

after-install::install.exec "killall -9 SpringBoard" 
#表示在Tweak安裝之后殺掉SpringBoard進程，好讓CydiaSubstrate在進程啟動時加載對應的dylib。

• Tweak.xm
  用Theos創(chuàng)建tweak工程，默認生成的源文件是Tweak.xm?！皒m”中的“x”代表這個文件支持Logos語法，如果后綴名是單獨一個“x”，說明源文件支持Logos和C語法；如果后綴名是“xm”，說明源文件支持Logos和C/C++語法
  關于Logos，請參考 http://iphonedevwiki.net/index.php/Logos

• control

control文件記錄了deb包管理系統(tǒng)所需的基本信息，會被打包進deb包里?；咀侄握f明：

Package：
用于描述這個deb包的名字，采用的命名方式同bundle identifier類似，均為反向DNS格式?？梢园葱韪摹?
Name：
用于描述這個工程的名字，可以按需更改。

Depends：
用于描述這個deb包的“依賴”?！耙蕾嚒敝傅氖沁@個程序運行的基本條件，可以填寫固件版本或其它程序，如果當前iOS不滿足“依賴”中定義的條件，則此tweak無法正常運行。如：Depends:mobilesubstrate,firmware(>=8.0)表示當前iOS版本必須在8.0以上，且必須安裝CydiaSubstrate才能正常運行這個tweak，可以按需更改。

Version：用于描述這個deb包的版本號，可以按需更改。
Architecture：用于描述deb包安裝的目標設備架構(gòu)，不要更改。
Description：是deb包的簡介，可以更改。
Maintainter：用于描述deb包的維護人，可以按需更改。
Author：用于描述tweak的作者，可以按需更改。
Section：用于描述deb包所屬的程序類別，不要更改。

• NIC.plist

該plist文件的作用和App中的Info.plist類似，它記錄了一些配置信息，描述了tweak的作用范圍。通過Xcode打開該文件，我們可以看到它的最外層是一個Dictionary，只有一個名為“Filter”的鍵。Filter下是一系列Array，可以分為三類：

Bundle：指定若干bundle為tweak的作用對象。如：com.apple.springboard

Classes：指定若干class為tweak的作用對象。如：NSString

Executables：指定若干可執(zhí)行文件為tweak的作用對象。如：callservicesd

這三類Array可以混合使用，但當Filter下有不同類的Array時，需要添加一個“Mode: Any”鍵值對。當Filter下的Array只有一類時，不需要添加。

（2）make編譯
（3）make package打包

問題1：

dpkg-deb: error: obsolete compression type 'lzma'; use xz instead

• 原因：
  原因是dpkg有兩個不同的版本，最新版本不支持lzma。
• 解決辦法：兩種
  第一種：修改配置文件

cd /usr/local/opt/theos/makefiles/package
sudo vim deb.mk 
將下面的變量改為(第六行)
_THEOS_PLATFORM_DPKG_DEB_COMPRESSION ?= gzip

第二種：降級

$ brew remove dpkg 
$ brew install --force-bottle https://raw.githubusercontent.com/Homebrew/homebrew-core/7a4dabfc1a2acd9f01a1670fde4f0094c4fb6ffa/Formula/dpkg.rb  
$ brew pin dpkg  

問題二

make[2]: Nothing to be done for `internal-library-compile'.

• 解決辦法
  按照問題1的解決辦法來

如果出錯要看更多信息，使用下面的命令
make package messages=yes
（4）make install安裝

安裝會讓你輸入兩次iphone密碼 , 默認是alpine

• 也可以一步到位 make package install 直接編譯, 打包, 安裝

再次執(zhí)行make package install之前需要清理之前生成的文件，
否則將安裝不成功。執(zhí)行以下命令達到清理的目的：
make clean
rm -rf ./obj ./packages

也可以在MakeFile里面配置
clean::
    rm -rf ./packages/* ./obj
這樣執(zhí)行make clean就可以了

安裝方式

1.如果沒有配置makefile,那么 make install就沒法使用，需要手動執(zhí)行安裝

//編譯打包
make
make package
//其實下面的過程就是make package做的事
cd packages
//將生成的包拷貝到iphone的tmp目錄
scp com.iosre.testtweak_0.0.1-18+debug_iphoneos-arm.deb root@192.168.0.101:/tmp
//連接iPhone后去到tmp目錄，就可以看到包
//安裝
iPhone:/tmp root# dpkg -i com.iosre.testtweak_0.0.1-18+debug_iphoneos-arm.deb
//如果hook的是springboard,就重啟一下，才能看到效果
 killall -9 SpringBoard

2. 自動安裝（寫腳本）

deb包里面的結(jié)構(gòu)：DEBIAN目錄 和 軟件具體安裝目錄（模擬安裝目錄）（如etc, usr, opt, tmp等）。

在DEBIAN目錄中至少有control文件，還可能有postinst(postinstallation)、postrm(postremove)、preinst(preinstallation)、prerm(preremove)、copyright (版權）、changlog （修訂記錄）和conffiles等。

• control文件：
  描述軟件包的名稱（Package），版本（Version），描述（Description）等，是deb包必須劇本的描述性文件，以便于軟件的安裝管理和索引。
• prerm文件：軟件卸載前需要執(zhí)行的腳本。
• postinst文件
  包含了軟件在進行正常目錄文件拷貝到系統(tǒng)后，所需要執(zhí)行的配置工作。內(nèi)容（ 軟件安裝完后，執(zhí)行該Shell腳本，一般用來配置軟件執(zhí)行環(huán)境，必須以“#!/bin/sh”為首行，然后給該腳本賦予可執(zhí)行權限：chmod +x postinst）：

# !/bin/sh
echo "my deb" >/home/mydeb.log

• postrm文件：
  軟件卸載后需要執(zhí)行的腳本。內(nèi)容（ 軟件卸載后，執(zhí)行該Shell腳本，一般作為清理收尾工作，必須以“#!/bin/sh”為首行，然后給該腳本賦予可執(zhí)行權限：chmod +x postrm）

# !/bin/sh
rm -rf /home/mydeb.lo

其他

• 安裝deb包
  dpkg -i com.iosre.testtweak_0.0.1-20+debug_iphoneos-arm.deb
• 查看deb包信息(其實也就是control文件的信息 )
  dpkg -I com.iosre.testtweak_0.0.1-20+debug_iphoneos-arm.deb
• 查看deb包目錄結(jié)構(gòu)
  dpkg -c com.iosre.testtweak_0.0.1-20+debug_iphoneos-arm.deb
• 刪除安裝的deb包

先dpkg -I XXX.deb,找到 Package: com.iosre.autoTwaek
然后 dpkg -r com.iosre.autoTwaek

• 查看日志

tail -f /var/log/syslog 
//查看指定日志
tail -f /var/log/syslog | grep SpringBoard
如果出現(xiàn) -sh: tail: command not found
去到Cydia,搜索Core Utilities，安裝
還要安裝syslogd： apt-get install syslogd
control + c  //退出查看

• 常用Logos語法簡介：

%hook 指定需要hook的類名，以%end結(jié)尾
%log 用來打印log的,將信息輸入到syslog中，如%log((NSString *)@"ZeluLi")
%orig 執(zhí)行被hook函數(shù)的原始代碼，類似于super.method功能
%group 該指令用于%hook的分組，%group后邊跟的是組名，%group也是必須以%end結(jié)尾，其中可以包含多個%hook
%init 該指令用來初始化某個%group，一個group只有被初始化后才可生效，init必須在hook中進行執(zhí)行。
%ctor tweak的構(gòu)造器，用來初始化，如果不顯式定義，Theos就會自動生成一個%ctor,并在其中調(diào)用%init(_ungrouped). 如：%ctor { %init(_ungrouped)}
%new 該指令用來給現(xiàn)有的class添加一個新的函數(shù)。與Runtime中的class_addMethod相同。
%c 該指令用來獲取一個類的名稱，類似于objc_getClass。