首页 > 代码库 > Instruments User Guide编程指南2-Common Tasks
Instruments User Guide编程指南2-Common Tasks
Launch Instruments
Instruments app在Xcode app的内部，所以最直接的方式启动Instruments就是从Xcode中启动，当然也可以间接通过 Dock, Launchpad, command line等工具启动。
Launch Instruments from Xcode
1：Open Xcode.
2：Choose Xcode > Open Developer Tool > Instruments.
建议：也能够使用该方式启动更多有用的开发工具
To profile an opened Xcode project
1：Launch Xcode and open your project.
2：Do one of the following:
1）Choose Product > Profile.
2) Click and hold the Run button in the Xcode toolbar and choose Profile.
3）Press Command-I.
Xcode创建工程，启动 Instruments，提示选择性能分析模板(profiling template)。如果需要使用相同的模板定期分析自己的APP，我们能够设置Xcode工程自动使用该模板，无论什么时候使用性能分析。
To set up an Xcode project to use a specific Instruments profiling template 建立Xcode工程使用具体的分析模板
1：Launch Xcode and open your project.
2：Choose Product > Scheme > Edit Scheme.
Or, from the Scheme pop-up menu in the Xcode toolbar, choose Edit Scheme.
Or, press Command–Less Than (<).The scheme editor dialog appears.
3：Click Profile in the sidebar of the scheme editor dialog. 点击编辑对话框中的Profile
4：Under Info, click the Instrument pop-up menu and choose the desired profiling template. 在Info下面，点击Instrument将弹出选择性能模板列表
如果选择Ask on Launch，当启动的时候，Instruments 将显示性能分析模板选择对话框。
5：Click Close. 点击关闭
6：Initiate profiling. See To profile an opened Xcode project. 开始性能分析，就是之前进行Podfile步骤
Launch Instruments from the Dock 使用Dock启动Instruments
To launch Instruments from the Xcode icon in the Dock 使用Dock中的Xcode启动Instruments
1：Open Xcode.
2：Control-click the Xcode icon in the Dock, and then choose Options > Open Developer Tool > Instruments from the shortcut menu.
也可以将 Instruments添加到Dock上，这是最快速的方式启动Instruments。
To permanently add Instruments to your Dock 永久显示Instruments在Dock上
1：Open Xcode.
2：Choose Xcode > Open Developer Tool > Instruments.
Instruments launches and its icon appears in your Dock. Instruments启动之后，Instruments的图标将显示在Dock中
3：Control-click the Instruments icon in the Dock, and then choose Options > Keep in Dock from the shortcut menu.
系统为英文：
系统中文：
Launch Instruments from Launchpad
Launchpad 自动显示APP在应用的目录中，因为Instruments 并不在应用目录中，所以并不会显示在Launchpad中。但是，我们可以添加Instruments到应用的目录，通过使用别名。
To add Instruments to Launchpad
1：Open Xcode.
2：Choose Xcode > Open Developer Tool > Instruments.
3：Control-click the Instruments icon in the Dock, and then choose Options > Show in Finder from the shortcut menu.
4：Option-Command-drag the Instruments app icon in the Finder to your Applications folder. An alias of Instruments is created and added to your Applications folder.
按住option + command 并拖动到应用目录下，我们就可以看到Instruments被创建了一个别名显示在应用目录中。
5： Remove the alias suffix from the filename of the Instruments alias.Instruments now appears in Launchpad.
Launch Instruments from the Command Line
使用命令行启动Instruments,能够使用终端下的open命令来启动在OS X 中任意APP。
To launch Instruments using the open command line tool
1:Launch Terminal (in
/Applications/Utilities/).2:Run the following command:
open /Applications/Xcode.app/Contents/Applications/Instruments.app。
Getting Around Instruments
Instruments有几个关键的窗口和对话框
Profiling Template Selection Dialog 性能分析选择
当Instruments启动，我们将可以看到一个对话框，包含一系列预先配置的性能分析模板，对话框中包含了一些标准的模板和我们创建的自定义模板，如下图：
Figure 5-1The profiling template selection dialog
性能分析模板包含以下基本部分：
Target device list: Click this to select the device on which you wish to profile. 点击选择我们想进行分析的设备
Target process list: Click this to select the process or processes to profile. 点击选择程序进行分析
Filter buttons: Click these to filter down the list of templates to display just the standard templates, custom templates, or recently used templates. 点击按钮过滤模板列表,调节标准模板，自定义模板，近期使用模板
Search field: Enter some text to quickly find the template you need. This searches template titles and descriptions. 输入模板title、描述，快速搜索需要的模板
Template list: The list of profiling templates, which may be filtered if you clicked a filter button or entered search criteria. 列举分析模板
Template description: A short description of the currently selected profiling template, which can be helpful for determining whether the selected template meets your needs. 简单的描述我们当前选中的模板，能够帮助我们确定是否选中模板是我们所需要的
Choose button: Click this to create a new profile document, based on the currently selected template.
This button changes to Profile when you press the Option key. Click the Profile button to create a new document based on the currently selected template and immediately begin profiling the target process. 基于当前选中的模板，点击创建一个新的性能分析文件。当我们按钮Option建的时候，该按钮将title变为Profile，点击Profile将立马自动开始分析目标程序。
Open button: Click this to open a previously saved profile document, rather than starting with a fresh template. 点击打开之前存储的profile文件，而不是开始一个新的模板
Cancel button: Click this to close the template selection dialog. 关闭选择框
建议：我们可以在使用Instruments情况下，通过选择 File > New (or pressing Command-N).在任意时间显示性能分析模板
Trace Document 跟踪文件或轨迹记录
trace document(Figure 5-2)被用于组织和配置instruments来进行分析，初始化数据集合，view和分析结果。通过启动Instruments并且选择性能分析模板(profiling template)将创建一个新的 trace document，也可以通过Xcode,Dock,Command Lin来初始化Profile.我们也可以保存并重新打开已经配置过的instruments中的trace document，在trace document中包含了许多的详情信息，这些信息可以通过相关的模板和区域显示出来。
Figure 5-2The trace document
Toolbar 工具栏
工具栏中允许我们开始(start)，暂停(pause)，停止数据分析，添加 instruments，隐藏和显示模板和更多相关操作。
Figure 5-3The trace document toolbar
工具栏包括以下主要部分：
Profiling controls: Allow you to record, pause, and stop data collection 允许进行录制，暂停，停止数据的收集
Target device list: Allows you to select the device on which you wish to profile. 目标设备，允许我们选择我们想分析的设备
Target process list：Allows you to select the process or processes to profile 目标进程，允许我们选择对应的APP
Activity viewer：Shows the elapsed time of the current trace or the position of the inspection head in the timeline pane. If your trace document has multiple data runs associated with it, that’s shown here too. 活跃观察者，显示当前路径(trace)经过的时间或者监控头在时间轴面板( timeline pane)中的位置.如果trace document 有多部分数据相关联，都会显示。
Add Instrument button (+): Shows or hides the instruments Library palette, which contains a complete list of available instruments. From here, you can select individual instruments and add them to your trace document. 显示和隐藏工具库( instruments Library)，包含了所有可使用的工具。这这里，可以选择独立的根据添加到当前的 trace document。
Strategy buttons: Control the type of information displayed in the timeline pane 策略按钮，控制在时间轴面板中的信息显示类型：
1）CPU (
):Displays a list of CPU cores, along with their collected data, in the timeline pane. Only available when a trace document contains instruments that record CPU data 在时间轴面板中显示CPU的核心部分和收集的数据。仅仅是在当前trace document包含记录CPU数据工具的时候可以使用
2）Instruments (
):Displays a list of instruments and their corresponding data in the timeline pane. 在时间轴面板中显示一 系列的工具和对应的数据
3）Threads (
):Displays a list of threads and their corresponding data in the timeline pane. Only available when a trace document contains instruments that record thread data 在时间轴面板中显示一些列的线程和对应的数据，仅仅是在当前trace document包含记录线程数据的根据才可以使用
View buttons: (
):显示和隐藏详情面板和监控部分
Timeline Pane
时间轴面板显示了给定trace的数据记录图形概要。在面板中，每一个工具，CPU core，thread都有自己的轨道(track),提供了已收集数据对应的图表，可以点击strategy buttons来查看。
虽然该面板的信息只是可读，但是能够滚动查看数据，并且选择具体的区域进行亲近检查，也可以插入相关的标志和高亮兴趣点。我们可以通过调节缩放等级，或者改变数据记录的设置来改变图表的显示信息。
Instruments strategy view
这里包含了所有独立的工具，包含你的跟踪文件,连同他们的收集数据。我们能够从工具库拖拽新的工具(Add an Instrument to a Trace Document)。如果我们选中了列表中的工具，我们能够删除它也可以在检查监控面板( inspector pane)中进行配置。当我们创建了trace document，列表中的根据默认是可见的：
Figure 5-4Instrument activity in the trace document timeline pane
CPU strategy view
如果trace document包含了instrument，CPU相关数据记录，CPU核心部分和对应使用的时间将被显示出来(Figure 5-5)。
Figure 5-5CPU activity in the trace document timeline pane
Threads strategy view
如果trace document中包含了instrument,记录的线程数据，相关的线程和它们的使用情况将显示在面板中：
Figure 5-6Thread activity in the trace document timeline pane
Detail Pane 详情面板
该面板显示trace document中的相关工具所记录的数据详情(seeFigure 5-7).选中时间面板中工具查看收集的数据：
Figure 5-7The trace document detail pane
Navigation bar
在详情面板的顶部的导航条(Figure 5-8)，帮助我们浏览已经收集的数据，我们能够使用导航条切换数据的类型以及显示不同等级的数据。
Figure 5-8The navigation bar in the trace document detail pane
Instrument: Icon of the currently selected instrument in the timeline pane. Click this to view the console for the instrument 该icon是在时间轴面板中当前选中的工具，点击图标可以切换到控制台打印观看输出情况
Detail type list: Allows you to navigate between different types of data. The options displayed here vary, depending on the actively selected instrument. For many instruments, the list includes things like a summary of data, a call tree, and a console 详情类型列表，允许导航不同类型的数据，该选项显示的变化，取决于当前选中的工具，对于许多的工具，列表都会包括数据的概要，调用树(call tree)，和控制台(console).
Detail tree: Keep track of where you are in the hierarchy as you navigate through the data in the detail pane. Click a branch of the tree to move back up the hierarchy to the corresponding data. 保持跟踪在视图层级的位置，并显示对应的数据。
Filter field:Allows you to filter collected data for a specific term. Click the filter field’s menu for some additional filtering options. You can also filter collected data more extensively by adjusting display settings in the inspector pane 允许为具体的term过滤集合数据，点击过滤区域将有一些其他的过滤选择。我们也可以在检查面板中进行显示调节设置，这样可以更加广泛的过滤数据。
Collected data area
集成数据区域(Figure 5-9)显示我们选中工具的所有数据，基本上的扁平格式。从一个工具(instrument)到另一个工具,显示的数据变化很大。例如：Activity Monitor instrument显示Process,CPU,thread information等。
Figure 5-9The collected data area in the trace document detail pane
一般情况下，个体对象和数据点所在的区域都包含导航按钮(
)，当我们指向的时候会显示出来。我们能够点击这些按钮移到到更深层次的数据部分，详情树在导航条中的更新反应了在层级中的位置，如Figure 5-10
Figure 5-10The trace document detail pane’s hierarchy navigation
Inspector Pane
该面板包含了instrument具体的设置(Figure 5-11)，能够控制录制行为，时间轴上的可视信息，详情面板。该面板有时也可以显示额外的信息能够被用于浏览数据。
Figure 5-11The areas of the trace document inspector pane
Record settings area
该区域可有用的设置取决于当前活跃的instrument，一般情况下，instrument提供了相应的设置允许我们调节特定的属性来怎样进行数据的记录，比如：采样率（sample rate）或统计捕捉的类型，如Figure 5-12：
Figure 5-12The record settings area of the trace document inspector pane
Display settings area
该区域的设置也是变化的，取决于instrument，这些设置能够帮助我们：
1：Control the data that appears in the detail pane. For example, an instrument may allow you to hide system libraries when navigating a call tree 控制详情面板上的显示数据。例如：当操作调用树(call tree)的时候，instrument可能允许隐藏系统库(system libraries)。
2：Navigate recorded data more efficiently through filtering and data mining 使用过滤和采集能够更有效的录制数据
3：Adjust how recorded information is represented in the timeline view. An instrument may, for example, allow you to change the style of graph used to represent its collected data 调节怎样显示录制信息在时间轴view上。例如：允许我们改变用于显示收集数据的图表样式.Figure 5-13显示了选中instrument的设置例子
Figure 5-13The display settings area of the trace document inspector pane
Extended detail area
该区域并不包含任意设置，相反，被用于显示在详情面板中选中数据的额外信息，比如：完整的堆栈轨迹，如Figure 5-14.
Figure 5-14The extended detail area of the trace document inspector pane
Library Palette
Library palette (Figure 5-15)提供了一个完整的可用instrument列表并且允许我们添加instrument到trace document。这里，我们可以浏览instrument的描述并且可以为具体的instrument进行过滤。为了显示Library palette，选择 Window > Library,press Command-L, or click the Add Instrument button (+) in the trace document toolbar.
Figure 5-15The Library palette
对于更多信息可以看：
Find Instruments in the Library Palette
Add an Instrument to a Trace Document
Flags Palette
Flags palette(figure 5-16)显示了一列旗帜用于时间轴面板中当前活跃的trace document。在Palette中，可以在timeline中快速使用flag进行标记。也能通过对大量的flag进行过滤得到具体的一个，显示和隐藏flag，查看flag的timestamp信息
Figure 5-16The Flags palette
Preferences Window
参数设置窗口(Figure 5-17)用于控制与instrument行为相关的各种设置。我们能够调节general设置启动，保存等。我们也能够调节录制设置，CPU设置，和对象选择(symbol preferences)。See Preferences有完整的一系列设置和选择能够被进行修改。
Figure 5-17The General preferences window
Create, Save, and Open Trace Documents
对于instrument，所有的工作都在trace document中进行，在trace document中包含了一系列的instrument。它们被配置好并且收集了数据。一旦使用trace document分析(profile)了APP，我们能够保存document来保存我们收集的trace data，并可以在之后打开用于观察和分析。
About Profiling Templates
当Instruments首先启动的时候，它提供了一系列的性能分析模板(see Figure 6-1).每一个模板都包含了一个工具集合能够用于分析APP和获取有用的信息来确认问题或使的APP执行更加有效。
Figure 6-1The profiling template selection dialog
无论什么时候为了特定的目标我们需要收集数据，我们应该计划使用分析模板作为起点。例如：如果我们想确认APP的内存问题，我们应该选择与内存相关的模板(memory-related template),比如：Allocations, Leaks, or Zombies。在使用了模板创建trace document之后，当需要的时候，我们能够经常添加或去除独立的instrument或重新配置instrument。
对于完整的可用列表模板，可用看：see Profiling Templates
Create a Trace Document
我们需要创建trace document来进行分析：To create a trace document
1：Launch Instruments. 启动Instruments
2：In the profiling template selection dialog that appears, select a target device and process. 在弹出的性能分析模板对话框中选择target和process。
3：Select the desired profiling template. 选中需要的性能分析模板
4：Click Choose. 点击choose，到这里新的document已经被创建并且配置了我们刚刚选中的instrument。
建议：为了在创建trace document之后自动开始APP性能分析，在性能分析选择对话框中可以按住option建。当我们操作之后，choose按钮变为了Profile.点击Profile创建document并且初始化，然后立马自动进行性能分析。如果我们找不到我们需要的模板或仅仅是想创建一个自己的模板，我们可以选择Blank template.
Save a Trace Document
一旦我们创建了trace document，我们能够保存它并且再之后进行引用。Instruments保存document作为使用.trace扩展名的Instruments trace文件
To save a trace document
1：Create a trace document. See To create a trace document. 创建跟踪文件
2：Choose File > Save. Or, choose File > Save As if you want to save a previously saved trace document as a new file.保存文件使用File > Save或者File > Save As保存之前的跟踪文件作为新的文件
3：Enter a name for the file. 输入文件名
4：Choose a destination for the file. 选择文件存储位置
5：Click Save. 点击保存
Save a Trace Document as a Profiling Template
如果我们创建trace document，考虑到需要再次用于分析其他APP，我们能够保存trace document作为自定义模板，这样我们就没有必要在运行Instrument的时候再一次创建跟踪文件。
To save a trace document as a profiling template
1：Create or open a trace document. See To create a trace document
2：Choose File > Save As Template.
3：Enter a name for the template.
4：Choose a destination for the template. 选择模板的存储位置
Save your template in the
/Users/<username>/Library/Application Support/Instruments/Templates directory to make it available in the custom section of the Instruments template window. This is the default directory in the Save As Template dialog.5：Select an icon for the template. 选择模板的icon
6：Enter a description for the template. 输入模板的描述信息
7：Click Save. 点击保存
Once you save a template, it automatically appears in the profiling template selection dialog, grouped with the Custom templates. Next time you create a trace document, you can select it as your starting point. 一旦我们保存了模板，它将自动显示在性能分析模板选择对话框中国，属于自定义模板部分，下一次当我们创建跟踪文件，我们能够选择它作为起始点。
Close a Trace Document
To close an opened trace document
1：Choose File > Close (or press Command-W).
2：If your document contains unsaved data, select whether to save the updated document. 如果文件中包含了未存储的数据，选择是否保存更新文件。
Open a Trace Document
To open a saved trace document 打开保存的跟踪文件，以下任意方式都可以：
1：在Finder中双击.trace文件
2：拖动.trace文件到Instrument图标APP
3：打开Instruments并在执行下列步骤：
1）Choose File > Open (or press Command-O).
2）Locate a saved
.trace document file.3）Click Open.
Target Devices and Processes
为了使用trace document来分析，我们需要把它作为目标(target).简单点理解就是，我们需要告诉Instruments 我们想要分析什么，对哪里进行分析，比如：是设备或者模拟器。
当我们创建了一个新的trace document，Instruments会显示性能分析模板选择对话框。在对话框的顶部包括了一个target列表和target process列表(如：Figure 7-1)，这允许我们当选择了模板之后指定目标(terget)。这些列表包括了任意的设备，有过配置的，或者与mac相连的设备，APP扩展，活跃的process，系统的process。
Figure 7-1Target device and process lists in the profiling template selection dialog
重点：有些与iOS相关的instrument，比如OpenGL ES Analyzer Instrument and GPU Driver Instrument是不能够运行在模拟器必须是真机。
Target list对于每一个trace document都有一个工具栏(see Figure 7-2),允许我们在trace document的任意时间改变target。
Figure 7-2Target device and process lists in the trace document toolbar
To target a device and a process
1：Click the target device list or target process list, and select the desired device and process. 点击target设备列表或者target process列表，选择需要的设备和process(程序)
有一些模拟器允许我们把所有的应用程序作为目标(target),如果我们想这么做，在Target Processes中选择All Processes
如果想要的程序不在列表中，在target process list中选择Choose Target ，这会显示一个对话框，允许我们浏览任意程序，我们也可以为程序配置环境变量。
建议：如果我们尝试着分析(profile)APP，但是APP并没有运行，instrument将自动启动程序。
Target an iOS Device
为了将iOS设备作为目标(target),需要将设备与Mac相连。一旦建立连接，设备将显示在目标设备列表( target device list)中,如下图所示：
Figure 7-3Targeting an iOS device in Instruments
注意：在使用Instruments进行APP性能分析之前，对于iOS设备必须提供相应的签证文件以至于能够收集数据。对于更多信息，可以看 Creating Development Provisioning Profiles in App Distribution Guide.
Target an iOS Device Wirelessly
Instruments也允许我们进行无线iOS设备数据收集，无线性能分析在以下情况非常有用：
Accelerometers：Move the device in all directions without its being tethered 向各个方向移动设备没有被限制
Accessories：Plug your USB accessory into the free slot and test it.
重要：正如前面提及的，在收集数据之前，设备必须提供开发所需的文件,Bongour和muticast也必须允许无线网络访问。更多信息：Bonjour Service Overview
To enable an iOS device for wireless profiling
1：Make sure your iOS device is connected to your development Mac by a USB or Lightning cable. 确保你的iOS设备通过USB连接到您的开发Mac或电缆。
2：Press the Option key, and click the target device list. 按住Option建，并且点击目标设备列表
3：Select your mobile device to enable wireless profiling for it. 选中自己的移动设备允许无线性能分析
4：Click the target device list again to open it, select the wireless version of your device, and select a process.
5：Disconnect the device from the USB or Lightning cable. You should now be able to profile the process wirelessly on your device. 去除设备与mac的链接，现在可以进行无线分析
Target an Apple Watch
在对Apple Watch进行instrument之前，必须提供一个Apple Watch
To prepare an Apple Watch for profiling
1：Ensure that your Apple Watch is paired with your development iPhone.
2：Quit Instruments.
3：Launch Xcode.
4：Connect the iPhone that’s paired with your Apple Watch to your development Mac by a USB or Lightning cable.
5：Choose Window > Devices (or press Shift-Command-2) to open the Devices window in Xcode.
6：Wait for the iPhone to appear in the Devices list.
7：Wait for the Apple Watch to appear as a paired device for the iPhone.
8：Wait for Xcode to indicate that the Apple Watch has been prepared. This process may take several minutes.
9：Disconnect the iPhone from the USB or Lightning cable.
10：Connect the iPhone to the USB or Lightning cable again.
一旦Apple Watch已经准备进行性能分析，启动instrument，Apple Watch应该显示在设备目标列表中，如下：
Other Ways to Target
这一节，我们已经学了怎样在Instruments中指定具体的目标APP和设备。我们也可以在没有实际的APP输入从外部选择APP设备，，有以下方式：
Profile from the Dock
Profile from Xcode
Profile from the Command Line
Access and Use Individual Instruments
在跟踪文件(trace document)内,独立的数据收集模块称之为instruments收集APP数据，过程(process),设备超时。每一个instrument收集并显示具体类型的信息，比如：文件的访问，内存使用，网络的活跃。Instrument包括大量的工具库，每一个工具都能够满足大多数开发者的需求。对于高级开发者，使用DTrace聚集其它类型的数据开发自己的自定义instrument。
注意：有一些Apple Apps，比如：iTunes, DVD Player, QuickTime，为了保护敏感或者版权数据这些APP将阻止Dtrace的数据收集。
Display the Library Palette
工具库(Figure 8-1)显示了所有我们能够添加到跟踪文件中的工具。包含了系统自带的标准instrument和自定义instrument。
Figure 8-1The Library palette
To display the Library palette
为了显示库，可以使用以下任一方法：
1：Click the Add Instrument button (+) in the trace document toolbar.
2：Choose Window > Library (or press Command-L).
Find Instruments in the Library Palette
在工具库中的显示的instrument列表是非常的长，如果我们添加了自定义的instrument到库中，那么instrument工具就更多了。所用我们可以使用底部过滤区域迅速找到我们所需要的instrument，基于名字，描述，关键字
Figure 8-2Filtering for instruments in the Library palette
Change the Library View Mode
instrument在库中能够被显示成icon， 或没有名字和描述。点击instrument库底部的视图按钮 (
)，可以显示每一个instrument对应的icon，如(Figure 8-3).为了再一次显示icon,姓名，描述，点击列表视图按钮 (
)
Figure 8-3The library palette in icon view
Add an Instrument to a Trace Document
不管是基于模板创建了跟踪文件还是空的跟踪文件，我们都可以添加新的instrument到跟踪文件以扩展功能。
To add an instrument to a trace document
1：Open the desired trace document. 打开需要的跟踪文件
2：Display the Library palette. 显示工具库
3：Find the desired instrument. 找到需要的instrument
4：Drag the instrument from the Library palette to the desired position in the strategy pane instruments list in your trace document. 从工具库拖动instrument到跟踪文件中的策略面板位置中。
Remove an Instrument from a Trace Document
当trace document在工作的时候，是非常容易去除instrument。
To remove an instrument from a trace document
1：Open the desired trace document. 打开跟踪文件
2：Select the instrument you want to delete in the strategy pane instruments list. 选中想要删除的instrument
3：Press the Delete key, or choose Instrument > Delete instrument name Instrument. 按住删除键或者Instrument > Delete instrument name Instrument
4：When prompted, click OK to confirm that you really want to remove the instrument. 在弹出框选着confirm进行删除
Configure an Instrument’s Record Settings
只要添加instrument到跟踪文件，工具就已经准备好使用了。在某些情况下，我们可能需要为instrument自定义设置。例如：可能希望为Activity Monitor instrument调节采样率或者在分析 Allocations instrument时为了空闲内存而丢弃事件。不同的instrument有着不同的可配置性，许多的instrument都包含了控制收集什么类型的信息。也可以在检测区域中的录制设置区域里调节这些设置。
Figure 8-4Record settings for the Activity Monitor instrument
Configure an Instrument’s Display Settings
在记录了trace之后，Instrument将显示结果在详情面板中。根据Instruments的不一样结果也不一样。它们可能包括概要(summary)，调用树(call tree),采样列表(sample list)，许多的数据都显示在这里。为了帮助我们获取正确的信息，Instrument经常允许我们进行调节，对信息进行过滤。如果Instrument支持这些操作，就像(Figure 8-5)显示一样。
Figure 8-5Display settings for the Activity Monitor instrument
Record, Pause, and Stop Traces
Record a Trace
当准备开始分析APP的时候，需要初始化记录(recording)。在跟踪文件(trace document)中的instrument将会更具事先的配置对APP进行监控。当记录发生，时间轴面板和详情面板将更新提供实时捕获的视图。
To begin recording
下面任一方法进行开始记录：
1：Click the Record button (
) in the trace document toolbar. 直接点击跟踪文件中的记录按钮
2：Choose File > Record Trace (or press Command-R). 选择File > Record Trace
Press Command-R again to stop recording. 按压 Command-R停止记录
Set Recording Options
设置记录选项是为了提高跟踪文件中数据的收集。可以在记录之前，选择延时，记录的时长，保存数据量的多少，在延时模式下是否记录数据等。
To set the recording options for a trace
1：Choose File > Record Options to open the Record Options dialog.
2：Customize the settings as desired. 定制设置需求
Options include:
Time limit: The maximum amount of time, in seconds, that the instruments will record data 最大的时间,以秒为单位,instrument将记录数据
Window limit: The maximum duration, in seconds, of data that will be saved. If recording continues for longer than the time you specify as the window limit (for example, longer than 4 seconds), only the data collected during the last 4 seconds is saved 最大持续时间,以秒为单位,数据将被保存。如果记录持续时间比所指定的时间窗的限制(例如,超过4秒)更长,只有在最后4秒保存收集的数据。
Deferred mode: Select to defer data analysis until after data collection is complete. This can result in faster and more accurate data collection, as more system resources are directed at the process being recorded. 选择推迟直到数据收集完成后进行数据分析。随着越来越多的系统资源针对过程被记录下来，这会更快和更准确的数据收集。
3:Click OK to close the Record Options dialog. 点击OK关闭记录选择对话框
Pause a Trace
如果有必要的话，我们可以进行暂停和恢复记录。
To pause an active recording
1：Click the Pause button (
) in the trace document toolbar.
2：Choose File > Pause Trace (or press Shift-Command-R).
Stop a Trace
一旦记录了所需要的数据，那么开始停止记录开始数据分析。
To stop an active recording
1：Click the Stop button (
) in the trace document toolbar.
2：Choose File > Stop Trace (or press Command-R).
Profile from the Dock
我们可以在Dock中点击Instrument图标来触发Time Profile,在后台自动记录某些事件。
To collect Time Profiler information from the Dock
1：With Instruments open, Control-click the Instruments icon in the Dock. 点击Dock中的Instruments打开Instruments。
2：From the shortcut menu that appears, choose the process to profile to start recording. 从显示的快捷菜单中选择需要分析的程序
Options include:
1：System Time Profile. Starts profiling all system processes. 开始分析所有程序
2：Time Profile Specific Process. Starts the Time Profiler instrument with a specific app from the submenu. 从子菜单栏指定具体的APP进行性能分析
3：Automatically Time Profile Spinning Applications. Automatically profiles blocked (spinning) apps in the future. 在将来自动分析阻塞APP
4：Allow Tracing of Any Process (10 hours). Trace any process that occurs in the next 10 hours. Bypasses having to enter a password during the 10 hours. 跟踪任何过程,发生在未来10个小时。绕过必须输入一个密码在10个小时。
Profile from Xcode
Instrument是Xcode开发流程中主要的组成部分，我们可以直接从Xcode中进行使用用于测试APP。
Profile from the build and product menus
Xcode编译菜单栏允许我们运行，测试，分析APP，也允许我们profile APP。
To profile your app from the Xcode build and product menus
1：Open an app project in Xcode.
2：Do one of the following:
1）Click and hold the build menu in the Xcode main window, and choose Profile from the menu that appears.
2）Choose Product > Profile (or press Command-I).
Instruments launches, and the profiling template selection dialog appears. Note that your app is automatically selected in the target device and process lists. 启动Instruments，并且选择分析模板对话框已经显示，并且可以看到已经自动选中了目标设备和对应是APP程序。
To use a default template when profiling from the Xcode build and product menus
1：Open an app project in Xcode.
2：Open the scheme editor dialog by doing one of the following: 使用以下任一方式打开编辑对话框
Select Edit Scheme from the target device list in the Xcode main window toolbar.
Choose Product > Scheme > Edit Scheme, or press Command–Less Than (<).
3：Click Profile in the sidebar of the scheme editor dialog. 在编辑对话框中的侧边栏选中profile
4：From the Instrument pop-up menu, choose the desired profiling template. 点击Instrument选项，选中想要的分析模板
5： Click Close.Now, whenever you profile your app, Instruments automatically opens it in the template you selected in the scheme editor dialog and starts profiling. 点击关闭， 现在，无论什么时候profile APP，instrument将自动打开之前选中的模板。
Profile from Xcode gauges while debugging
Xcode调试导航(debug navigator)包括一些仪表用于监控APP，方便测试和调试。这些仪表跟踪了各种各样的因素，包括CPU使用，内存，能量影响，并且能够警告你潜在的影响性能的问题，电量使用等。如果在测试APP的时候确认了所想要的趋势，希望进一步研究，能够过渡监控到instrument获取更加详细的分析。
To initiate profiling from an Xcode gauge
1：Open an app project in Xcode and run it.
2：While your app is running, display the debug navigator by doing one of the following:
Click the Debug Navigator button in the navigator selector bar.
Choose View > Navigators > Show Debug Navigator (or press Command-6).
3：Click the desired gauge in the debug navigator.
4：Click the gauge’s Profile in Instruments button in the main editor.
注意到，并不是Xcode的每一个仪表都有Profile in instrument按钮。Energy Impact 仪表部分，包括了一些按钮用于初始化不同类型的分析会话(profiling sessions in Instrument).
5：When prompted, select whether to transfer the currently running instance of your app over to Instruments or stop the app and start a new instance of it with Instruments. 当弹出提示框的时候，选择是否转移当前运行的APP实例到instrument或者停止当前在instrument开始一个新的实例
Profile from the Command Line
Profile with instruments
使用instrument命令行工具来分析APP并制定具体的模板而不需要启动Instrument ,数据在分析期间存储到指定目录下的
.trace文件中。在分析完成之后，可以使用instrument来打开记录的数据文件，观察显示的数据。To profile with instruments
1：Open Terminal, in
/Applications/Utilities.2：Enter an
instruments command to collect data. For example, the following command profiles an app with the Allocations template and saves the results to the desktop in a
.trace file.- 3：Open Instruments, and choose File > Open.
4：Find your saved
.trace file, and click Open.在打开保存的文件之后，Instrument将自动添加相关到工具到跟踪文件并且使用收集数据填充。为了找到问题所在，我们可以看和分析数据。
instruments Options：
instruments provides the following set of configuration options for defining what data to collect.Configuration Option | Description |
|---|---|
| The name or path of the profiling template to use when analyzing your app. |
| Returns a list of all installed profiling templates. |
| The path where the |
| The amount of time to record, in milliseconds, before terminating. If not provided, recording occurs indefinitely, until the app is manually terminated. |
| The index of the instrument to use for recording. |
| The process ID of the app to be recorded. |
| The path of the app to be recorded. |
| The ID of the device to target. |
| An environment variable to be applied while profiling. |
| A command-line argument to be passed to the app being profiled. Multiple arguments may be specified, if desired. |
| Enables verbose logging while profiling. |
Collect and view data with iprofiler
使用 iprofiler命令行工具 (see iprofiler(1) Mac OS X Developer Tools Manual Page)来测试APP性能而不需要启动instrument。在收集了性能数据之后，为了视觉化显示数据导入到instrument中。收集的数据被profiler保持为.dtps。更多内容，请看官方文档。
Minimize Instruments Impact on Data Collection
Instruments工具的目的是减少自己对数据收集影响。通过改变一下基本的设置，能够进一步减低instrument对数据的影响。为了收集更多的数据，能够为许多的instrument减少采样间隔。短的采样时间间隔得到高采样频率，同时导致了一些问题：
Processor time is required for every sample. High sample rates use more processor time. 高采样率将需要更多的处理时间
Sample interval timing may not be consistent. Interrupts are used to start each sample. Variations in when these interrupts occur can cause significant variations in the sample rate when using very small sample intervals. 启动中断用于每次开始一次取样。当使用非常小的样本间隔，这些中断发生的变化会导致采样率显著变化。
Small sample intervals cause more samples to be taken. Each sample uses system memory, and a large number of samples quickly uses up the available memory on machines with less memory. 每一次取样都使用系统内存，大量的迅速采样将使用的机器上的变量有较少的内存使用
Run Instruments in Deferred Mode
通过延时数据分析，即一直到停止正在测试的APP，增加性能相关数据的准确性。当APP运行的时候Instrument分析和显示数据，允许我们查看收集的数据。通过占用CPU时间和内存执行性能分析会减缓目标过程,这让你的测量可能不会反应正常的处理行为。运行instrument在延迟模式分析数据,直到数据收集完成后,或者在你的应用程序运行结束之后或者在单击停止。在延迟模式中,你是无法收集数据与设备进行交互。
在延时模式下，instrument完成数据收集之后，instrument将处理数据并且显示在屏幕上。推迟数据分析将时间添加到数据收集过程的后期,但它有助于确保性能相关数据是准确的。
To set deferred mode for Instruments
1：Choose Instruments > Preferences.
2：In the Recording pane, select the “Always use deferred mode” checkbox.
对于特别长的跟踪，由延时模式所导致的延时将会有很大的影响。
To set deferred mode for a trace
1：Choose File > Record Options.
2：In the dialog that appears, select the Deferred Mode checkbox and then click OK. 在显示的对话框中，选中延时并点击Done
如果在Instruments — >preferences中设置了“Always use deferred mode” ，该选项失效。
Instruments User Guide编程指南2-Common Tasks
声明：以上内容来自用户投稿及互联网公开渠道收集整理发布，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任，若内容有误或涉及侵权可进行投诉： 投诉/举报 工作人员会在5个工作日内联系你，一经查实，本站将立刻删除涉嫌侵权内容。