build and export Xcode projects with Grunt
Objective-C JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
tasks
test
.editorconfig
.gitignore
.jshintrc
.npmignore
.travis.yml
Gruntfile.js
LICENSE
README.md
package.json

README.md

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

Install

$ npm install grunt-xcode --save-dev

Usage

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

grunt.initConfig({
    xcode: {
        options: {
          project: '/path/to/my/awesome/App/App.xcodeproj',
          scheme: 'Release'
        }
    }
});

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

Examples

Coming soon.

Options

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

Related

Contributing

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.

License

MIT © Matias Singers