Find file
Fetching contributors…
Cannot retrieve contributors at this time
63 lines (51 sloc) 4.41 KB

grunt-xcode Build Status Dependency Status Gitter

Build and export Xcode projects with Grunt

NB. recently did a complete rewrite of this plugin, please see blog post: grunt-xcode v2


$ npm install grunt-xcode --save-dev


require('load-grunt-tasks')(grunt); // npm install --save-dev load-grunt-tasks

    xcode: {
        options: {
          project: '/path/to/my/awesome/App/App.xcodeproj',
          scheme: 'Release'

grunt.registerTask('default', ['xcode']);


Coming soon.


default type description
clean true Boolean Clean project before building
export true Boolean Export the project after building/archiving
project '' String Project (.xcodeproj) file to use to build app
configuration '' String Configuration used to build('Debug' or 'Release' in most projects)
Available configurations for a project can be listed with $ xcodebuild -list
workspace '' String Workspace (.xcworkspace) file to use to build app, scheme must be passed along with workspace
scheme '' String Scheme used to build app
allTargets true Boolean Will by default build all targets in project.
If allTargets is false and no target option is passed, the first available target will be built.
target '' String Build the target specified, by default will build all available targets - see allTargets option.
Available targets for a project can be listed with $ xcodebuild -list
archivePath '' String Path to archive the build to (useful for saving DSYM etc.)
If nothing is provided a temp directory will be created and removed after completion.
exportFormat 'IPA' String Valid formats are IPA (iOS archives only), PKG (Mac archives only), and APP.
exportPath process.cwd() String Path to exported IPA file. Defaults to current directory
exportFilename 'export.ipa' String Filename of the exported IPA file.
exportProvisioningProfile '' String Profilename of the provisioning profile to be used when exporting the archive.
exportSigningIdentity '' String Identityname of the application signing identity to be used when exporting the archive.
If possible, this may be inferred from exportProvisioningProfile.
If nothing is specified the signing identity used to create the archive will be used.
exportInstallerIdentity '' String Identityname of the installer signing identity to be used when exporting the archive.
If possible, this may be inferred from exportProvisioningProfile or exportSigningIdentity
arch '' String Build with specified architecture
sdk '' String Passed as [<sdkfullpath> | <sdkname>] when building the project
Available SDKs can be listed with $ xcodebuild -showsdks



In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.


MIT © Matias Singers