App Development Starter Kit

Deprecation Warning! The content below is only applicable for use within deprecated 1.x versions of the CA Agile Central App SDK. Use of the component(s) and/or code on this page is not supported. To develop custom apps within our current environments, please see App SDK 2.1 documentation.

The App Development Starter Kit was developed to allow you to create apps using the same tools that CA Agile Central uses internally. For more information on the basics of app development see Getting Started.

Software Requirements

java (required for jslint support; recommended)

Ensure java is included in the global PATH.

ruby (Windows only- comes with OSX)

The starter kit has been tested against v1.8.7 of ruby.


Rake is a build tool for ruby and can be installed from the command line:

> gem install rake


Download and uncompress the starter kit from the link located at the bottom of this page.

The starter kit contains the following items:

  • Examples: Example apps that can be built using the toolkit
  • lib: New app templates and the jslint4java jar file
  • Rakefile: Contains targets for building apps

Rakefile Usage

The rakefile is used to manage all parts of the app development process. The following targets are defined:

> rake -T
rake combine # Merge all css and js into one app html file
rake default # Default task (equivalent to deploy)
rake deploy # Run jslint and combine
rake jslint # Runs JSLint on all app JavaScript files
rake new[app_name] # Create a new app

Create an App

This task creates a new directory with an html, css, and js file for app development.

> rake new[AppName]
Creating directory AppName...
Creating AppName.css...
Creating AppName.js...
Creating AppName.template.html...

Add any app styles to the css file and any app javascript to the newly created js file. The template.html file references both of them so running, debugging, and testing your app is as simple as opening the template.html file in Chrome or Firefox.

Note that in order to support running outside of CA Agile Central, the SDK is included as a fully qualified URL from On-premises users should adjust the template.html file to reference the correct server. More information on using apps outside of CA Agile Central can be found here.

Also note that the SDK is included in debug mode for development (?debug=true). More information on SDK query string parameters can be found here.


This task examines your javascript and can help detect common problems like missing semicolons. Note this task requires java.

> rake jslint
Running jslint...

-------JSLint output for AppName.js--------------
jslint:AppName.js:3:10:Missing semicolon.

Deploy To CA Agile Central

Once development and debugging is complete it is time to combine the html, css, and js files into one html file which can be easily pasted into a CA Agile Central custom tab.

> rake combine
Processing AppName.template.html...
Concatenating AppName.css...
Concatenating AppName.js...

Creating merged app html file AppNameApp.html...
AppNameApp.html successfully created!

Alternatively, you can invoke the deploy target. This is the same as combine but also runs jslint. This is also the default and can be invoked by typing rake.

> rake deploy
Running jslint...

-------JSLint output for AppName.js--------------

Processing AppName.template.html...
Concatenating AppName.css...
Concatenating AppName.js...

Creating merged app html file AppNameApp.html...
AppNameApp.html successfully created!

Paste the contents of the generated App.html file into a custom tab to begin using it in your CA Agile Central workspace.

Note that the generated App.html file no longer references the App SDK using a fully qualified URL and so can no longer be run outside CA Agile Central. Instead, the SDK will be loaded from the CA Agile Central server in which the app is running.



Benötigen Sie weitere Informationen? Die CA Agile Central-Community ist Ihre zentrale Anlaufstelle für Self-Service und Support. Treten Sie der CA Agile Central-Community bei, um dem CA Agile Central-Support Feedback mitzuteilen oder Fälle zu melden, Antworten zu finden oder mit anderen Benutzern zusammenzuarbeiten.