Tutorials & Guides

Tutorial: Setting up  XCode and Building the App Tutorial: Setting up  XCode and Building the App

1. Download Xcode 6 1. Download Xcode 6

You can get XCode 6 here.

Top ↑

2. Check out the source 2. Check out the source

Our official repository is hosted at GitHub. Follow the instructions there to get the source code on your machine.

Top ↑

3.  Setup ~/.wpcom_app_credentials 3.  Setup ~/.wpcom_app_credentials

Our build process uses a file placed in our root folder called .wpcom_app_credentials to generate a class with API keys used by our app. We fill this file out with the relevant app secrets (Pocket, Google+, etc.) so the app will work properly. Here’s a sample file you can download and place in your root folder (make sure you fill it out with the proper keys).  You’ll want to add values for WPCOM_APP_ID and WPCOM_APP_SECRET taken from these instructions if you want to connect to WordPress.com.

Top ↑

4. Setup your device or use the iOS Simulator 4. Setup your device or use the iOS Simulator

At this point you should be able to use the iOS Simulator or if you have a paid Apple developer account you should be able to build the device on your iOS device.

Top ↑

Problems building the project Problems building the project

Here’s a list of common build issues.

Top ↑

Mach-o-linker Error Mach-o-linker Error

If you’ve successfully built the project in the past but get this error now, it’s most likely a framework dependency that can’t be loaded. Solution:

  1. Select the WordPress project file in the Project Navigator
  2. Go to the Build Settings tab.
  3. Open “Search Path” (towards the middle) and expand “Framework Search Paths”.
  4. If you have paths listed here, remove them for Beta and Debug.
  5. Given that Xcode can now find the frameworks the project should now build fine.

More info on Stack Overflow.

Top ↑

Apple LLVM 5.0 Error Apple LLVM 5.0 Error

If you cannot build the project and instead receive an error such as the following:

clang: error: no such file or directory: '/tmp/WordPress.build/WordPressComApiCredentials.m'
clang: error: no input files
Command /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang failed with exit code 1

Solution:

The path into which you’ve checked out your working copy may contain a space (such as “Desktop/my folder” instead of “Desktop/my-folder”). Replace any spaces in the full path with anything other than a space (for example underscore, dash, plus sign).