Strange recommendation in Service Management documentation

While checking the "Updating helper executables from earlier versions of macOS" (Ref. https://developer.apple.com/documentation/servicemanagement/updating_helper_executables_from_earlier_versions_of_macos), the first recommendation is to:

Install the helper executable within the app bundle, such as in Contents/Resources.

This is a bit surprising considering that, AFAIK, "Contents/Resources" has always been considered a bad location for executables.

[Q] Is this an error in the documentation or is putting the helper executables in the Contents/MacOS directory not recommended anymore?

Answered by DTS Engineer in 739721022

Is this an error in the documentation … ?

Yes. I’d appreciating you filing a bug against the docs. Please post your bug number, just for the record.

The canonical reference for where stuff goes in a bunch is Placing Content in a Bundle.

Share and Enjoy

Quinn “The Eskimo!” @ Developer Technical Support @ Apple
let myEmail = "eskimo" + "1" + "@" + "apple.com"

vs.

Ref. https://developer.apple.com/documentation/bundleresources/placing_content_in_a_bundle

help app, helper tool. macOS. Contents/MacOS/ Contents/Helpers/ macOS framework. Versions/A/Helpers/

Accepted Answer

Is this an error in the documentation … ?

Yes. I’d appreciating you filing a bug against the docs. Please post your bug number, just for the record.

The canonical reference for where stuff goes in a bunch is Placing Content in a Bundle.

Share and Enjoy

Quinn “The Eskimo!” @ Developer Technical Support @ Apple
let myEmail = "eskimo" + "1" + "@" + "apple.com"

Strange recommendation in Service Management documentation
 
 
Q