Installing Action Data Quick Start Guide

For iOS , tvOS and macOS development with Swift and Xcode
Sample Apps

Discover Action Data

Thank you for trying our Action Data collection of time saving functions and utilities for working with data across wide range of mobile and desktop apps. We hope you enjoy using our components and that they become a valuable part of your developer environment.

This guide is designed to help you get up and running with Action Data quickly and easily in your own app projects.

Installing Action Data

Use the following steps to install Action Data on your development computer:

  1. Double-click the Install Package to start the installation process and click the Continue button:
  2. The Read Me section describes what has changed in the current version. Click the Continue button:
  3. Accept the License and click the Continue button:
  4. If needed, click the Customize button to modify what is installed where:
  5. Click the Install button to start the install process:
  6. Enter your credentials and click the Install Software button:
  7. When the install finishes, click the Close button:

With the install completed, the necessary frameworks will be added to your /Library/Frameworks/ActionData and /Library/Frameworks/ActionUtilities directories:

Within each of those directories will be subdirectories for each of the OSes that the frameworks support. For example iOS, tvOS and macOS. When you are adding the framework to a project, you’ll need to use the correct version for the OS that the app project will run on.

Adding Action Data to an App Project

Our components were designed to be quickly added to your app’s project with a minimum of code, making it easy to add high-quality, professional features and functionality to your apps.

NOTICE: In addition to installing the Action Data framework, you will need to install the required Action Utilities framework that is available for free here.

In Xcode, do the following:

  1. Open an app project or start a new one.
  2. Select the Project in the Project Navigator, select the General tab and scroll down to the Embedded Binaries section:
  3. In Finder, open the /Libraries/Frameworks/ActionUtilities folder, then the folder for the appropriate OS version:
  4. Drag the framework into the Embedded Binaries section in Xcode.
  5. You can select to Copy items if needed  and a copy of the framework will be placed inside of the app project or you can use the framework from its current location. Click the Finish button:
  6. Return to Finder, open /Libraries/Frameworks/ActionData folder and again select the version for the appropriate OS version:
  7. Drag the framework into the Embedded Binaries section in Xcode.
  8. Again, you can Copy items if needed or use the shared version. Click the Finish button:
  9. The both frameworks will be added to both the Embedded Binaries and the Linked Frameworks and Libraries sections:

You are now ready to use the Action Data suite in your app project. Include the import ActionData statement at the top of any class you want use a component from. For example:

import UIKit
import ActionUtilities
import ActionData

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view, typically from a nib.
        do {
            try ADSQLiteProvider.shared.openSource("MyDatabase.db")
            ...
        } catch {
            print("Unable to open database.")
        }
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }


}

Component Documentation

The Action Data Developer Center was designed to help you get the most out of our developer tools by providing a selection of Articles, Guides, Samples and Quick Start References for each component in the suite.

Additionally, each tool in the Action Data Suite has a fully documented API, with comments for every element included: