Build Instructions (iOS)

Quick links

Other sites

Except as otherwise noted, the content of this page is licensed under a Creative Commons Attribution 2.5 license, and examples are licensed under the BSD License.

For Developers‎ > ‎How-Tos‎ > ‎

Note: Upstreaming of iOS code is still in progress, and a substantial amount of code (especially in chrome/) is not yet built. In particular, note that it is not currently possible to build the actual browser binary, only unit tests and libraries. Unless you are actively working on upstreaming iOS code into the Chromium repository, these instructions are not likely to be interesting at this point.

Prerequisites

A Mac running 10.7+.
XCode 4.5, including the current iOS SDK
Install gclient, which is part of the depot_tools package (download). gclient is a wrapper around svn/git that we use to manage our working copies.
(optional) Install git.

Setting Up

In the directory where you are going to check out the code, create a file called chromium.gyp_env with the following contents:

{
'GYP_DEFINES': 'OS=ios', # use space to delimit additional defines.
'GYP_GENERATOR_FLAGS': 'xcode_project_version=3.2',
}

Also, you should install API keys.

Getting the Code

Check out the code using either the new git workflow or svn method (do not use the tarball), following the iOS specific instructions. For either one, after you run gclient config but before you run gclient sync, add the two bolded lines below to the end of your .gclient file.

solutions = [
  ...
]
target_os = ['ios']

target_os_only = True

Building

Build the target you are interested in. Since Xcode 4 has difficulty opening Chromium projects, you may want to use xcodebuild. Example command lines, depending on the target, device, and configuration you want to build:

xcodebuild -project build/all.xcodeproj -target "All" -configuration Debug -sdk iphonesimulator build

xcodebuild -project base/base.xcodeproj -target "base" -configuration Release -sdk iphoneos build

You should always be able to build all:All, since targets are added there for iOS only after they compile.

Running

Any *_unittests target that runs on the bots (see below) should run successfully in a local build. Nothing else runs yet—see the highlighted note at the top of this page.

Check the bots periodically for updates; more targets will come on line over time.

Troubleshooting

If your build fails, check the iOS columns of the Mac waterfall (the last two) to see if the bots are green (in general they should be, since failures on those bots will close the tree).

If you followed a previous version of these instructions and added a long list of None entries to your .gclient file, remove them all (the exclusions are now handled by DEPS) and re-sync. Until you remove them, you will see failures such as missing files under skia/include.

Comments