Palm Developer Center

How To: Version Control

All version control operations are located in the menu above the File Tree in the left-most column of the Ares UI, in a dropdown menu with a safe icon.

What you must do first!

  1. In the Version Control menu, select Setup Keychain. This will open the setup keychain dialog
  2. Choose a password for your keychain, which will be used to generate a key that secures your Version Control credentials on the Ares server.
  3. Once you have entered your password twice, select the Generate button to generate this key, then close the dialog.
  4. You are now set for using version control on Ares.

 

Checking out a project from source control

  1. From the Version Control menu, select “Checkout Project” to bring up the Checkout Project dialog
  2. For VCS type, select from the available version control systems Ares supports
  3. For URL, enter the complete URL for your project on your server, including the root folder for the application itself.
  4. For Project Name, enter the name of the project you want to use locally within Ares for your application
  5. For Keychain Password, enter the keychain password you selected above
  6. For Username, enter the username for your account on the remote version control server
  7. For Password, enter the password for your account on the remote version control server
  8. Select OK - you should see the results of the checkout operation in the dialog, and the application will appear in the file tree.

 

Adding a project to source control

  1. From the Version Control menu, select “Add project to Source Control” to bring up the Add dialog
  2. For VCS type, select from the available version control systems Ares supports
  3. For URL, enter the URL for your version control server - it must be accessible from Ares - meaning accessible from the internet. NOTE: at the end of the url, you MUST also add a name for the directory you want Ares to create and place your project within. This is the most common issue users encounter in version control on Ares.
  4. For Keychain Password, enter the password you set up in the keychain dialog above
  5. For Username, enter the username for your account on the remote version control server
  6. For Password, enter the password for your account on the remote version control server
  7. Select OK
  8. You can view the results of the version control operations in the Log Viewer by selecting VCS from the log type dropdown
  9. After a short time, your project should be added to your version control server, and you will get a confirmation message in the dialog

 

Performing operations

Version control operations in Ares can be performed on a project-level basis - the entire project must be checked in or out at a time, but otherwise there are no restrictions.

The rest of the version control menu will now be unlocked when you select the top level folder for your project. The operations are performed similar to the command-line, with results displayed in the log.