Instance Method

unload

Unloads the code associated with the receiver.

Declaration

- (BOOL)unload;

Return Value

YES if the bundle was successfully unloaded or was not already loaded; otherwise, NO if the bundle could not be unloaded.

Discussion

This method attempts to unload a bundle’s executable code using the underlying dynamic loader (typically dyld). You may use this method to unload plug-in and framework bundles when you no longer need the code they contain. You should use this method to unload bundles that were loaded using the methods of the NSBundle class only. Do not use this method to unload bundles that were originally loaded using the bundle-manipulation functions in Core Foundation.

It is the responsibility of the caller to ensure that no in-memory objects or data structures refer to the code being unloaded. For example, if you have an object whose class is defined in a bundle, you must release that object prior to unloading the bundle. Similarly, your code should not attempt to access any symbols defined in an unloaded bundle.

Special Considerations

Prior to OS X version 10.5, code could not be unloaded once loaded, and this method would always return NO. In macOS 10.5 and later, you can unload a bundle’s executable code using this method.

See Also

Loading Code from a Bundle

executableArchitectures

An array of numbers indicating the architecture types supported by the bundle’s executable.

- preflightAndReturnError:

Returns a Boolean value indicating whether the bundle’s executable code could be loaded successfully.

- load

Dynamically loads the bundle’s executable code into a running program, if the code has not already been loaded.

- loadAndReturnError:

Loads the bundle’s executable code and returns any errors.

loaded

The load status of a bundle.

Mach-O Architecture

Constants describing the CPU types that a bundle’s executable code supports.