チゼル

Chiselは、iOSアプリケーションのデバッグを支援するLLDBコマンドのコレクションです。

[ インストール • コマンド • カスタムコマンド • 開発ワークフロー 貢献 • ライセンス ]

LLDBの包括的な概要、およびチゼルの補完方法については、Ari Grantの「 Dancing in the The Debugger」 、「 objc.io」 19号のLLDBを持つWaltzを 参照してください 。

インストール

brew update
brew install chisel

.lldbinitファイルが存在しない場合は、それを作成して端末でタップして開くことができます

touch .lldbinit 
open .lldbinit 

~/.lldbinitファイルに次の行を追加します。

# ~/.lldbinit
...
command script import /usr/local/opt/chisel/libexec/fblldb.py

あるいは、チゼルをダウンロードし、 〜/ .lldbinitファイルに次の行を追加します。

# ~/.lldbinit
...
command script import /path/to/fblldb.py

コマンドは、次回Xcode起動したときに利用可能になります。

コマンド

多くのコマンドがあります。 ここにいくつかあります：（ 右のiOS / Macとの互換性）

すべてのコマンドのリストを表示するには、 LLDB helpコマンドを実行するか、 Wikiを参照してください。

(lldb) help
The following is a list of built-in, permanent debugger commands:
...

The following is a list of your current user-defined commands:
...

リストの一番下には、 Chiselから供給されたすべてのコマンドが含まれます。

他のすべてのLLDBコマンドと同様に、helpコマンドの引数として名前を渡すことで、特定のコマンドを検査することもできます。

(lldb) help border
Draws a border around <viewOrLayer>. Color and width can be optionally provided.

Arguments:
  <viewOrLayer>; Type: UIView*; The view to border.

Options:
  --color/-c <color>; Type: string; A color name such as 'red', 'green', 'magenta', etc.
  --width/-w <width>; Type: CGFloat; Desired width of border.

Syntax: border [--color=color] [--width=width] <viewOrLayer>

Chiselによって提供されるすべてのコマンドには、冗長なヘルプが付属しています。 それが疑わしいときは必ず読んでください！

カスタムコマンド

ローカルのカスタムコマンドを追加できます。 ここには工夫した例があります。

#!/usr/bin/python
# Example file with custom commands, located at /magical/commands/example.py

import lldb
import fblldbbase as fb

def lldbcommands():
  return [ PrintKeyWindowLevel() ]
  
class PrintKeyWindowLevel(fb.FBCommand):
  def name(self):
    return 'pkeywinlevel'
    
  def description(self):
    return 'An incredibly contrived command that prints the window level of the key window.'
    
  def run(self, arguments, options):
    # It's a good habit to explicitly cast the type of all return
    # values and arguments. LLDB can't always find them on its own.
    lldb.debugger.HandleCommand('p (CGFloat)[(id)[(id)[UIApplication sharedApplication] keyWindow] windowLevel]')

それから、lldbinitでコマンドをソースするだけです。 Chiselはこのためのpython関数、 fblldb.pyモジュールのloadCommandsInDirectoryがあります。

# ~/.lldbinit
...
command script import /path/to/fblldb.py
script fblldb.loadCommandsInDirectory('/magical/commands/')

また、コマンドが取る引数やオプションを簡単に指定できるようにするための組み込みサポートもあります。 使用例については、 borderおよびpinvocationコマンドを参照してください。

開発ワークフロー

ローカルでの使用であろうとChisel直接貢献であろうと、コマンドを開発することは同じワークフローに従います。 「 カスタムコマンド」セクションの説明に従ってコマンドを作成し、

1. LLDB開始する
2. ブレークポイントに到達する（または、 Xcodeのデバッグバーで一時停止ボタンを押すか、直接接続さprocess interrupt場合はprocess interruptする）
3. LLDBのcommand source ~/.lldbinit実行して、 command source ~/.lldbinit実行します
4. 作業しているコマンドを実行する
5. コマンドを変更する
6. オプションで、 script reload(modulename)実行しscript reload(modulename)
7. コマンドが幸福の源になるまでステップ3〜6を繰り返す

貢献する

あなたが作成した一般的なコマンドを投稿してください。 それがあなたを助けたらそれは他の多くの人々を助けるでしょう！ ：D寄付方法については、 CONTRIBUTING.mdを参照してください。

ライセンス

ChiselはBSDライセンスを受けています。 LICENSE参照してください。