Instance Method

unload()

Unloads the code associated with the receiver.

Declaration

func unload() -> Bool

Return Value

true if the bundle was successfully unloaded or was not already loaded; otherwise, false 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 false. In macOS 10.5 and later, you can unload a bundle’s executable code using this method.

See Also

Loading Code from a Bundle

var executableArchitectures: [NSNumber]?

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

func preflight()

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

func load() -> Bool

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

func loadAndReturnError()

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

var isLoaded: Bool

The load status of a bundle.

Mach-O Architecture

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