Daniel Duan's Articles About Instruments

Daniel Duan's Articles About Instruments https://duan.ca/tag/instruments/ Using Instruments on Non-macOS, Non-iOS Executables How do you use use Instruments, the instrumentation tool distributed alongside Xcode? It's easy if you are profiling a macOS or iOS app. No so with a regular old command-line tool built, say, with SwiftPM. To do so, you'll need to codesign the target binary. Otherwise Instruments will give you a <code>"Failed to gain authorization"</code> error message. Here's the steps: <ol> <li>Create a entitlement file with <code>com.apple.security.get-task-allow</code> set to true:</li> </ol> <pre><code class="language-xml"><?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>com.apple.security.get-task-allow</key> <true/> </dict> </plist> </code></pre> Let's call it <code>Entitlements.plist</code> <ol start="2"> <li> Build the executable. </li> <li> Codesign your executable with the entitlement file </li> </ol> <pre><code>codesign -s - -f --entitlements path/to/Entitlements.plist path/to/executable </code></pre> Now proceed with your profiling in Instruments. Not sure where this is officially documented. So I'm officially documenting it here. Thu, 31 Mar 2022 20:39:05 -0700 https://duan.ca/2022/03/31/instrumenting-commandline-executables/ https://duan.ca/2022/03/31/instrumenting-commandline-executables/