When you build an iOS application project in Xcode, you create an application bundle. The application bundle contains the application executable and any resources you have bundled with your application. Resources are things like storyboard files, images, and audio files – any files that will be used at runtime. When you add a resource file to a project, Xcode is smart enough to realize that it should be bundled with your application.

How can you tell which files are being bundled with your application? Select the LootLogger project from the project navigator. Check out the Build Phases pane in the LootLogger target. Everything under Copy Bundle Resources will be added to the application bundle when it is built.

Each item in the LootLogger target group is one of the phases that occurs when you build a project. The Copy Bundle Resources phase is where all the resources in your project get copied into the application bundle.

You can check out what an application bundle looks like on the filesystem after you install an application on the simulator. Start by printing the application bundle path to the console.

    print(Bundle.main.bundlePath)

Then, navigate to the application bundle directory using the steps you followed in the section called Saving the Items. Then Control-click the application bundle and choose Show Package Contents (Figure 13.9).

Figure 13.9  Viewing an application bundle

A Finder window will appear showing you the contents of the application bundle (Figure 13.10). When users download your application from the App Store, these files are copied to their devices.

Figure 13.10  The application bundle

You can load files from the application’s bundle at runtime. To get the full URL for files in the application bundle, you need to get a reference to the application bundle and then ask it for the URL of a resource.

    // Get a reference to the application bundle
    let mainBundle = Bundle.main

    // Ask for the URL to a resource named MyTextFile.txt in the bundle resources
    if let url = mainBundle.url(forResource: "MyTextFile", ofType: "txt") {
        // Do something with URL
    }

If you ask for the URL to a file that is not in the application’s bundle, this method will return nil. If the file does exist, then the full URL is returned, and you can use this URL to load the file with the appropriate class.

Bear in mind that files within the application bundle are read-only. You cannot modify them, nor can you dynamically add files to the application bundle at runtime. Files in the application bundle are typically things like button images, interface sound effects, or the initial state of a database you ship with your application. You will use this method in later chapters to load these types of resources at runtime.