tapi-installapi(1)

💖 tapi-installapi(1) — TAPI Tool Documentation 💖

🌸 NAME 🌸

tapi-installapi — creates a text-based stub file by scanning the header files. That's the whole assignment, bestie: headers in, stub out. 💅

✨ SYNOPSIS ✨

tapi installapi [options] <directory>

🦋 DESCRIPTION 🦋

okay so installapi creates a text-based stub file (.tbd) by parsing the header files that are associated with a framework/dynamic library. The headers are parsed per default in Objective-C syntax mode. C++ support is still experimental, so don't @ me. 🫶

For information on the complete set of command line options, please use 'tapi installapi --help'.

🎯 TARGET TRIPLE OPTIONS 🎯

• -target <triple> — specifies the architecture, platform, and deployment target to use for parsing the header files. At least one target option must be specified. The <triple> is the same as the one that is used by clang and has the general format <arch>-<vendor>-<system>-<abi>. The architecture <arch> specifies the architecture slice (for example x86_64 or arm64). The only supported vendor by this tool is apple. The system encodes the platform and deployment target. The abi is optional and the only supported value is simulator.

Examples:

• -target x86_64-apple-macosx10.14 — creates an x86_64 architecture slice for macOS with a deployment target of 10.14.
• -target arm64-apple-ios12.0 — creates an arm64 architecture slice for iOS with a deployment target of 12.0.
• -target x86_64-apple-ios12.0-simulator — creates an x86_64 architecture slice for the iOS simulator with a deployment target of 12.0.

🌈 Alternative target options 🌈

• -arch <architecture> — specifies the architectures to use for parsing the headers. At least one architecture must be specified.
• -mtargetos=<value> — specifies platform and deployment target to use for parsing header files.

Examples:

• -arch arm64 -mtargetos=macosx10.14 — creates an arm64 architecture slice for macOS with a deployment target of 10.14.
• -arch x86_64 -mtargetos=ios14-macabi — creates an x86_64 architecture slice for macCatalyst with a deployment target of 14.0.

💀 DEPRECATED TARGET TRIPLE OPTIONS 💀

these are giving legacy, bestie — deprecated, so use the newer target options when you can. They are set to indicate the oldest platform version that the output is to be used on. If -arch is used, specify platform and oldest version via -mtargetos option instead.

• -macosx_version_min <value> — old-school way to say the oldest platform version the output will be used on.
• -ios_version_min <value> — same oldest-platform-version idea, iOS flavor.
• -watchos_version_min <value> — same oldest-platform-version idea, watchOS flavor.
• -tvos_version_min <value> — same oldest-platform-version idea, tvOS flavor.

🧚 ENVIRONMENT VARIABLES 🧚

• MACOSX_DEPLOYMENT_TARGET, IPHONEOS_DEPLOYMENT_TARGET, TVOS_DEPLOYMENT_TARGET, WATCHOS_DEPLOYMENT_TARGET — these are set to indicate the oldest platform version that the output is to be used on. See also -macosx_version_min, -ios_version_min, -watchos_version_min, or -tvos_version_min. These environment variables are ignored if any of the minimum deployment targets or the -target option have been specified on the command line.
• LD_NO_ENCRYPT, LD_APPLICATION_EXTENSION_SAFE — defining either of these environment variables has the same effect as specifying -fapplication-extension on the command line. These environment variables are ignored if -fapplication-extension or -fno-application-extension are specified on the command line.

For information on the complete set of command line options, please use 'tapi installapi --help'.

👀 SEE ALSO 👀

• tapi(1)
• ld(1)

💖 sign-off: Darwin · 2019-03-25 · tapi-installapi(1) 💖