说明:从左到右,依次是“导航窗格(Navigator)->边列(Gutter)->焦点列(Ribbon)->代码编辑窗口(Standard/Primary Editor)”。
边列(Gutter):显示行号和断点。
焦点列(Ribbon):灰色深度与代码嵌套深度相关:鼠标悬停可突出显示右侧相应代码块(Focus code blocks on hover),鼠标单击可折叠右侧相应代码块(Code folding)。
通过“command+,”快捷键或”Xcode|Preferences”菜单呼出偏好设置。
选中一种主题(theme),例如“Midnight”,推荐使用Monokai、Ciapre。将 `*.dvtcolortheme` 文件拷贝到 `~/Library/Developer/Xcode/UserData/FontAndColorThemes/`即可安装主题, 重启 Xcode 即可选用。
Xcode默认字体为menlo,也可选择 Consolas、Monaco、Consolas、Droid Sans Mono、Source Code Pro、Bitstream Vera Sans 等其他等宽字体。
shift 选择主题 Source Editor/Console 中的所有项,点击 Fonts 可更改字体(大小)。
Editing:
Focus code blocks on hover:鼠标悬停时突出显示右侧相应代码块。
Indentation:
Downloads:可下载Components(SDK&Simulator)和Documentation。
不建议使用绝对路径,因为写死之后,换环境或换平台,又要重新修改路径,且同名project target的build folder会覆盖,建议使用相对路径(Relative)
option+点按:查看选中符号的帮助提示(Quick Help for Selected Item)。
option+双击:打开选中符号的帮助文档。
command+0:Show/Hide left tool panel(Navigator Area)
command+1-8:Project/Symbol/Find/Issue/Test/Debug/Breakpoint/Report Navigator
option+command+0:Show/Hide right tool panel(Utility Area)
option+command+1/2:show the file/quick help inspector
可按下command+0隐藏左侧栏Navigator,再按下option+command+0隐藏右侧栏Utility,只显示Standard/Primary Editor,聚焦有效利用屏幕进行编码。
control+1:Show Related Items(例如Superclasses/Subclasses、Callers/Callees、Protocol Implementor/Implemented、Includes/Included By)。可输入实时搜索匹配。
control+2/3:Show Previous/Next History。可输入实时搜索匹配。
control+4:Show Top Level Items。
control+5:Show Group Files(当前文件夹内的所有文件)。可输入实时搜索匹配。
control+6:Show Document Items(当前文件的Symbols)。可输入实时搜索匹配。
command+shift+[/]:切换标签页
单/双指左右滑动(control+command+←/→):在单标签页打开的多个文件间切换(Go Back/Forward)
command+L:跳转到指定行。
shift+command+O:Open Quickly,快速全局查找文件、符号,非常常用!
command+点击Editor中选中的符号:跳转到符号定义(jump to definition)。
control+command+J:跳转到指定符号的定义处或实现处(Go to Declaration/Definition)。有时工程正在Loading、Indexing或Processing files时,“command+点击”无法响应,此时可试试control+command+J。
control+command+↑/↓:切换头文件/实现文件(switch between a source file (.m,*.mm,*.cc) and the associated header file(.h),Jump to Previous/Next Counterpart)。
在Project Navigator中选中文件右键或通过菜单“File->Show in Finder”:在Finder中定位该文件。
command+2可聚焦左侧导航栏中的符号导航器。
注意:control+6只列出当前代码所在interface的符号,而Symbol Navigator是当前工程(Project Scope)的所有符号列表的Hierarchy,符号种类包括Classes/Protocols/Functions/Structs/Unions/Enums/Types/Globals。
编辑器中光标所在符号处,Navigate菜单或右键快捷菜单可[Reveal in Symbol Navigator],在符号导航器中定位当前符号,亦可查看当前符号所属类的层次。
option+command+←/→:折叠当前代码块,包括@interface …@end、@implementation …@end
option+shift+command+←/→:折叠该文件内所有代码块(方法/函数:{ Methods&Functions })
control+shift+command+←/→:折叠当前注释块(/*Comment Blocks*/)
(shift+)option+command+`:MoveFocus to (Previous)Next Area.
command+J:焦点切换(Move Focus),可配合鼠标和方向键。带‘+’的“Move focus to a new assistant editor”可以快速在辅助编辑窗口中打开头文件(*.h)/实现文件(*.m,*.mm)。
shift+command+J:在项目导航中定位当前编辑其中打开的文件(Reveal in Project Navigator)。
control+command+N:File | New | Workspace
shift+command+N:File | New | Project
command+X/C/V:剪切/复制/粘贴
command+Z(+shift):撤销(重做)/Undo(Redo)
command+[/]:向前/向后缩进(Shift Left/Right)
option+command+[/]:将当前光标所在行代码上移/下移一行(Move Line Up/Down)
command+/:以双斜杠(//)注释选中的代码,再此按下可取消
Parentheses/Brackets/Braces Matching:双击某个分隔符(如()、[]、{} 等),Xcode会选中匹配代码块。
Editor→Structure→Balance Delimiter:根据当前光标代码所在位置,自动向外扩展选择外层代码块。
esc(control+.)就当前输入上下文呼出/隐藏智能提示列表(Auto Completion List);
上下方向键(↑/↓)在智能提示列表中选择选项。当然,也可以用control+.;enter选中列表中备选的消息符号;
tab在輸入符号不完整时可一截一截匹配;选中消息符号后,tab可在各个参数占位符之间移动,enter可选中参数占位符先临时补位填充。
输入Objective-C对象及消息名,然后输入 ],自动补充对象名左侧的[,完成中缀符(infix natation)包围。
当鼠标定位或选中某个符号时,可呼叫右键快捷菜单:
对应Find菜单中有Find Selected Text in Project、Find Selected Symbol in Project(control+shift+command+F)、Find Call Hierarchy(control+shift+command+H)。
说明:Find Call Hierarchy等效于control+1|Callers。
command+F:当前文件查找。
shift+command+F(command+3):在Find Navigator中全局查找。可在[Preferences-General]中设置Find Navigator Detail的显示行数(当Navigator Area较窄挤压时)。
对于查找出来的结果可以delete删除非预期干扰结果条目,也可以多择或全选Find Results拷贝出来整理分析。
option+command+F:当前文件替换。
option+shift+command+F:在Find Navigator中全局替换。
例如,光标停留在NSMutableArray的insertObject:atIndex的前半截单词insertObject上时:
有三种复制方式:
通过后两种快捷方式,可以便捷地复制Objective-C特殊的冒号分隔的消息符号名称。
<1>在左侧导航栏(Project Navigator)中选中某个文件右键快捷菜单中有【Open with External Editor】,默认呼叫Mac OS X自带的文本编辑器(TextEdit)打开。我们可以按照以下步骤设置快捷键:
可针对Xcode工程代码文件(*.h/*.hh/*.c/*.cc/*.m/*.mm)设置默认打开程序为Sublime Text.app:右键Get Info(command+I),Open With选择Sublime Text.app并且Change All。然后,Xcode|Open with External Editor将在Sublime Text打开选中文件。
<2>另外,可下载安装OpenInSublimeText插件,支持呼叫SublimeText打开Xcode当前正在编辑的文件。
Assistant Editor有点类似VC中的Code Definition Window,可实现分屏查看代码Counterpart,方便交叉参考代码编辑。
可通过菜单[View|Assistant Editor]设置Assistant Editors的方向,例如On Right。
在Mac OS X日常操作中,我们已经认识到option这把单刀双掷开关的妙用:按住鼠标移动或三指触控移动时,按下option键可实现竖直块选;调节音量/亮度时,按住option+shift 可以四分之一单位微调。
使用Xcode快捷键进行切换或跳转动作时,若同时按下option可以在辅助编辑窗口中打开相应文件或符号(For optional navigation (Option-clicking or Option-choosing a file), opens the file in a new Assistant editor pane.)。若在辅助窗口中操作,则在主窗口(Standard Editor)中打开。
点击查看shift+command+O、shift+command+F(command+3)选中的文件或符号时,可同时按下option在辅助编辑窗口中打开。
在control+1~6中打开选择结果时,均可同时按下option在辅助编辑窗口中打开。
在Xcode以上种种切换跳转操作时,按下option的同时按下shift,通常会呼出一个导航窗格(option+command+<),可选择在new window/tab/assistant-editor打开显示。
For Option-Shift navigation (Option-Shift-click or Option-Shift-choose a file), Xcode displays a graphical navigation chooser showing the current layout. The chooser prompts you to open the file in any open editor pane in any window and tab, or to open the file in a new editor pane, window, or tab.
命令行进入HelloWorld工程目录,执行xcodebuild命令并带上“-showBuildSettings”参数:
$ xcodebuild -project HelloWorld.xcodeproj -target HelloWorld -configuration Debug -showBuildSettings > xcodebuild_showBuildSettings.txt
则xcodebuild_showBuildSettings.txt中保存了Build settings for action build and target "HelloWorld”,其中dump了所有的环境变量。
约定1:~=当前账户的HOME目录,例如“/Users/faner”。
约定2:build构建基础路径:BUILD_PATH = ~/Library/Developer/Xcode/DerivedData/Build。可通过“File->Project Settings”查看Derived Data Location。
约定3:环境变量宏(Build Setting Macros)引用格式:${MACRO},同Build Phases Run Script中的语法。
下面是摘选自xcodebuild_showBuildSettings.txt的部分常用环境变量。
ARCHS = i386
CURRENT_ARCH = i386
PLATFORM_DIR = /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform
PLATFORM_NAME = macosx
SDKROOT = /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.9.sdk
SDK_DIR = /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.9.sdk
SDK_NAME = macosx10.9
PROJECT = HelloWorld
PROJECT_DIR =~/Projects/Learn Objective-C/HelloWorld
PROJECT_FILE_PATH =${PROJECT_DIR}/HelloWorld.xcodeproj
PROJECT_NAME = HelloWorld
SOURCE_ROOT =${PROJECT_DIR}
SRCROOT =${PROJECT_DIR}
BUILD_DIR =BUILD_PATH/Products
BUILD_ROOT =BUILD_PATH/Products
BUILT_PRODUCTS_DIR =BUILD_PATH/Products/Debug
CONFIGURATION = Debug
CONFIGURATION_BUILD_DIR =BUILD_PATH/Products/Debug
CONFIGURATION_TEMP_DIR =BUILD_PATH/Intermediates/HelloWorld.build/Debug
PRODUCT_NAME = HelloWorld
PRODUCT_TYPE = com.apple.product-type.tool// Project Template: Command Line Tool
TARGET_BUILD_DIR =BUILD_PATH/Products/Debug
TARGET_NAME = HelloWorld
Product -> Edit Scheme(option+command+R)->Arguments->Environment Variables中可以添加自定义环境变量(Name为名称,Value为值)。
在Xcode|Build Phases中Add Run Script Build Phase的Run Script将会使用到环境变量。
一个Target是指在一个Project中构建的一个产品,它包含了构建该产品的所有文件,以及如何构建该产品的配置。
一个定义好构建过程的Target成为一个Scheme,可在Scheme中定义Target的六种构建过程:Build/Run/Test/Profile/Analyze/Archive。
Product ->Edit Scheme(编辑配置,快捷键为 option+command+R 或 shift+command+,/command+<)->Manage Schemes可对Scheme的六种构建过程进行配置(可配置项包括Info、Arguments、Options)。
在 Project Navigator 中选中某个 xcodeproj(例如 QQ.xcodeproj),将进入 Project Setting 页面,可点击左侧图标 show/hide project and targets list:
点击 targets 项可分别设置各 target 的 Build Settings;右击可对 target 进行 delete。
Architectures:Supported Platforms(OS X、iOS),Base SDK,(Valid)Architectures(armv7、arm64、i386)。
Build Locations:配置构建目录,包括Intermediate Build Files Path、Build Products Path及其针对Per-Configuration的配置。
Build Options:
Code Signing:包括Entitlements、Identity和Provisioning Profile,详情参考《iOS Provisioning Profile(Certificate)与Code Signing详解》。
Deployment:配置发布及安装选项。
Linking:
Packaging:
Search Paths:
Apple LLVM 7.0配置:
⭐️Code Generation:
⭐️Custom Complier Flags:
⭐️Language
⭐️Preprocessing:定义Preprocessor Macros,例如DEBUG、NDEBUG=1。
⭐️Warning Policies:例如可以提高警告级别当作错误(Treat Warnings as Errors:YES)。
Target Dependencies:设置依赖target。
Copy Bundle Resources:拷贝的资源文件。
Compile Sources:该target需要编译的源代码文件。可输入搜索源代码文件名(xxx.mm),查看或编辑其编译选项(Compiler Flags),例如 -fobjc-arc 表示 ARC(__has_feature(objc_arc))。
Link Binary with Libraries:需要链接的库(*.a、*.framework)。
Embed App Extensions:该APP对应的扩展插件。
可以点击加号,New Run Script Phase,配置custom actions after compiling the Xcode project,相当于Visual Studio的Post-builtstep。
当然,也可以在Edit Scheme中设置Pre-actions(custom actions after compiling the Xcode project)、Post-actions(将在编译链接完成后执行脚本)。
以下Shell脚本将生成的二进制(Unix executable)文件HelloWorld拷贝到~/Software,然后cd到该目录下并执行HelloWorld:
shift+command+K:清除products|debug或release下的Unix executable文件。
option+shift+command+K:删除构建目录(Delete/Clean Build Folder),清理Derived Data对应target目录下的Build文件夹(包括intermediate和products)。通常用于重新编译整个工程,尝试解决增量编译时部分符号陈旧导致链接不通过的问题。
Product -> Edit Scheme(option+command+R)->Info->Build Configuration:选择生成版本(Debug or Release)
command + B:构建(Buid)
command+8可聚焦左侧导航栏中的日志报告导航器,其中可以查看Build日志。
command+4可定位Issue Navigator:
当编译错误(error)和警告(warning)过多时,点击底端的感叹号,即可忽略编译警告,只显示编译错误:
command + R:运行(Run),可能会重新编译链接。
option+command + R:如果确定代码没有改动,加option键可免重新编译链接,直接运行上次build成功的product(Run Without Building)。
command + .:停止运行(Stop)。
定义好Target构建配置后,接下来需要指定目标机编译。
目标机的iPhoneOS.platform必须>=Deployment Target,且Xcode必须支持该机型:/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport/目录下必须含有对应iOS系统版本的DeveloperDiskImage.dmg,否则真机编译会提示Could not find developer disk image。
shift+command+2:可以查看当前连接的Device和支持的Simulator。
control+option+command+[/]:Select Previous/Next Destination,在连接多个真机或模拟器之间切换。
shift+command+Y:显示控制台(Show/Hide the debug area)
shift+command+C:激活聚焦控制台,光标定位到控制台呈可输入状态
command+K:清除控制台(Debug->Debug Workflow->Clear Console)
可安装BBUDebuggerTuckAway插件,在打字coding时,自动隐藏调试控制台
command + \:当前行设置/取消断点;通过鼠标点击边列中的蓝色断点来启用/禁用当前行断点。
command + Y:全局激活或禁用所有的断点,激活进入调试模式(此时断点蓝色可见)。
边列(Gutter)中的断点/警告可右键呼出Reveal in Breakpoint/Issue Navigator。
trick:编辑断点(Edit Breakpoint):
Condition:设置断点的触发条件,例如“i==3”(注意不能有空格)表示当i等于3时该断点才会被触发。
Ignore:设置断点需要被忽略多少次才会中断,若设置成5则表示第6次遇到该断点时才触发。
Action:设置断点触发时的动作,可以为Debugger Command、Log Message、Shell Command或Sound。
例如可设置以下Debugger Command:
[1]读取std::string sig的内存buffer值:mem read sig.c_str() -c sig.size();
[2]打印NSData实例sig:po sig
F6:下一步(Step Over),逐过程单步调试,不进入函数体。
(fn+)F7:进入(Step Into)函数体。可能与多媒体键有冲突,故需要fn辅助(建议将功能键F1-F12设置为标准的功能键)。
(fn+)F8:跳出(Step Out)函数体。可能与多媒体键有冲突,例如呼叫iTunes,故需要fn辅助。
control+command+Y:逐断点继续执行(Pause/Continue)。
control+command+C:执行到当前光标所在行(Continue to current line)。
trick:移动指令指针(Move the instruction pointer):
断点调试运行时,可以将绿色指针箭头(Line 47)移动到其他行(Line 49)或其他断点(Line 51)实现跳转执行。
command+8可聚焦左侧导航栏中的日志报告导航器,其中可以查看Debug日志。
shift+command+M:Debug Workflow->View Memory。
Debug Workflow->Show Disassembly When Debugging,可进行汇编指令级调试。
trick:修改变量内存值(change memory value while debugging):
调试运行时,可以在底部的调试窗口(Debug Area,可通过Shift+Command+Y呼出)右键某个变量,除了可以进行View Memory/View Value As之外,还可以选择Edit Value运行时编辑内存变量的值。
在调试验证某些难以复现的bug或进行边界测试时非常有用,可减少每次修改测量样本值(hardcode)重新编译链接的痛苦。
// 打印SYSTEM_VERSION(可能要加UIDevice*转换)
(lldb)p [[[UIDevicecurrentDevice] systemVersion] doubleValue]
// 打印屏幕bounds(可能要加UIScreen*转换)
(lldb)po NSStringFromCGRect([[UIScreen mainScreen] bounds])
// 打印状态栏frame(可能要加UIApplication*转换)
(lldb)po NSStringFromCGRect([UIApplication sharedApplication].statusBarFrame)
// 打印当前keyWindow的根视图(可能要加UIViewController*转换)
(lldb)po [[[UIApplication sharedApplication] keyWindow] rootViewController]
// 调用后,继续运行程序,view的背景色将变成红色
(lldb) call [self.view setBackgroundColor:[UIColor redColor]]
x/memory read:dump指定地址的内存(Read from the memory of the process being debugged),后接起止地址或-c指定count加起始地址。可help mem read查看帮助:
Syntax:
memory read
Command Options Usage:
size指定内存块(block/chunk)的大小
--size
count指定内存块(block/item)的个数,可配合起始地址使用。
-c
format指定内容显示格式,格式符同print:c-char,s-string,d-decimal,x-hex。
-f
Command Samples:
(a)起止地址,以下基于起始地址偏移量指定截至地址。
(lldb)mem read 0x10b88f0c 0x10b88f0c+9
0x10b88f0c: 39 38 37 36 35 34 33 32 31 987654321
(b)可在起始地址后使用-c指定需要dump的字节数,以上等效:
(lldb)mem read 0x10b88f0c -c 9
0x10b88f0c: 39 38 37 36 35 34 33 32 31 987654321
(c)起始地址+内存块size+内存块count(dump hex format)
(lldb)memory read -s 1 -f x -c 9 0x10b88f0c
0x10b88f0c: 0x39 0x38 0x37 0x36 0x35 0x34 0x33 0x32
0x10b88f14: 0x31
说明:dump的memory chunk为1byte,以上总共dump了chunk size*chunk count=9byte。
(d)起始地址+内存块size+内存块count(dump char format)
(lldb)memory read -s 1 -f c -c 9 0x10b88f0c
0x10b88f0c: 987654321
(e)起始地址+内存块size+内存块count(dump string format)
(lldb)mem read 0x10b5cf2c -f s -c 1
0x10b88f0c: "987654321"
(f)起始地址+内存块size+内存块count(dump int format)
(lldb)memory read -s 4 -f x -c 3 0x10b88f0c
0x10b88f0c: 0x36373839 0x32333435 0x109f0031
说明:以上指定chunk尺寸为4byte(-s 4),chunk数量为3,共dump了12个byte。
Syntax: memory write
trick:lldb打印无效问题
在使用LLDB调试命令p/po打印C类型(包括复合类型)或Objective-C对象时,可能会遇到属性不存在或类型不匹配的问题。
例1——断点调试,打印当前UIViewController的frame:
例2——断点调试,打印当前UIViewController的navigationController堆栈和childViewControllers数组:
点引用报错写法(property not found):(lldb) po self.navigationController.viewControllers
调用getter正确打印:(lldb) po [[self navigationController] viewControllers]
点引用报错写法(property not found):(lldb) po self.childViewControllers
调用getter正确打印:(lldb) po [self childViewControllers]
当你对已释放的对象发送消息(90%的可能是对引用计数为0的对象再release)或release那些autorelease对象时,就会出现报EXC_BAD_ACCESS这样的错误。
默认设置下 Xcode不会给你定位具体是哪一行代码不该去使用已释放的对象,或者release用错了。
Product -> Edit Scheme(option+command+R) -> Diagnostics ,勾选“Objective-C”之后的“Enable Zombie Objects”。
设置NSZombieEnabled环境变量后,一个对象销毁时会被转化为_NSZombie;设置NSZombieEnabled后,当你向一个已经释放的对象发送消息,这个对象就不只是报EXC_BAD_ACCESS Crash,还会放出一个错误消息,然后以一种可预测的可以产生debug断点的方式消失, 因此我们可以找到具体或者大概是哪个对象被错误的释放或引用了。
注意:NSZombieEnabled只能在调试的时候使用,千万不要忘记在产品发布的时候去掉,因为NSZombieEnabled不会真正去释放dealloc对象的内存,一直开启后果自负!