Setting up SVN version control with FlexBuilder
This page discusses the integration of Subversion into FlexBuilder.
Open Flex Builder and do the following:
Subversion 1.5 has resolved this problem by discontinuing the use of APR-ICONV. Instead, Subversion will use translation routines that are provided by the Windows operating system.
Procedure If you do not yet have your project ready to import into the repository, create a simple project that contains a few files so that they can be stored in the repository. A simple way to achieve this is to create a sample plug-in project by selecting File > New > Project... and Plug-in Development > Plug-in Project. Give the project a name and click through to finish on the wizard.
To import a project into the repository, right click the project you want to import and select Team > Share Project... from the context menu. Do not use "import" and select subversion.
This will begin the Share Project wizard. Select SVN as the repository type and click Next.
If you have already defined the repository location you want to store this project in, then select it in the list and click Next. Otherwise, select the Create a new repository location option and click Next. If you need to create a location then see the section on creating a new repository location in the Flexbuilder user manual for more information.
You must specify the folder name where you want to store the project. The folder name is relative to the URL of the repository location you specified in the previous step. All intermediate folders must already exist in the repository, but the final folder name must not already exist. You can use the Browse... button to select a path from within the repository. The Browse dialog also allows you to create folders, so you could use that option to create any intermediate folders. In the above example, we are going to follow the convention of storing the project in a ProjectName/trunk structure. In this example, the ProjectName folder must already exist and the trunk folder must not exist. Click Next or Finish when you are through.
The final page of the wizard is just a final confirmation page. When you click Finish, SVN will issue the mkdir command to create an empty folder in the repository. It will then checkout that folder on top of your local project. This will create the .svn folder inside your project, converting it into a valid Working Copy. Finally, the wizard will bring up the Commit Dialog so that you can commit everything into the repository. You do not have to commit everything or even anything. You may want to cancel the commit dialog and then go back to your workspace and do everything from the Team menu. For example, if you wanted to set SVN properties as part of the commit, you would want to first use the Team > Add to Version Control option and then use the Team > Set Property option etc. Once you have things the way you want them you can then perform a Team > Commit.
For more and the most up to date details on how to do this please refer to the FlexBuilder online help and go to: Workbench User Guide > Getting started > Team SVN tutorial.
Installing Subclipse
The following are instructions for setting up Subversion for Adobe Flex Builder 3 (taken from [1] and [2]). It was last verified on 2009-03-10 to work ok:Open Flex Builder and do the following:
- Help menu → Software Updates → Find and Install → Search for New Features to Install → Check Europa Discovery Site (do not check automatically select mirrors) → Finish
- Select a mirror from the List that appeared → Ok
- In the new list expand Europa Discovery Site → expand Java Development → select Plug-in Development Enviroment and Java Development Tools → Next → Accept the terms and conditions → Next → Finish
- Restart Flex Builder
- Help menu → Software Updates → Find and Install → Search for New Features to Install → Button: New Remote Site → Enter the following: name: Subclipse, URL: http://subclipse.tigris.org/update_1.0.x/
- Then a new entry should appear in the list with the list with sites for search → Expand Subclipse → Expand Subclipse Plug-in → Check Subclipse 1.2.x (available version might be different when you read this) → Next → Accept the terms and conditions → Next → Finish
- Restart Flex Builder
Subversion 1.5 has resolved this problem by discontinuing the use of APR-ICONV. Instead, Subversion will use translation routines that are provided by the Windows operating system.
Getting the source code from the SVN repository
We use a subversion repository at sourceforge, see IBIS-ID SourceForge repository for the checkout address. Once you have access you can check out the source code. Here are some instructions that are copied from Flexbuilders manual:Import a new Project into a SVN Repository
Overview This is the process for taking a local project in your Eclipse workspace and importing it into a repository so that it can be managed by SVN. If you have already been using SVN and you have an existing working copy in your workspace that you want to connect to SVN, then you will likely want to follow the procedure for Connecting an Existing Project.Procedure If you do not yet have your project ready to import into the repository, create a simple project that contains a few files so that they can be stored in the repository. A simple way to achieve this is to create a sample plug-in project by selecting File > New > Project... and Plug-in Development > Plug-in Project. Give the project a name and click through to finish on the wizard.
To import a project into the repository, right click the project you want to import and select Team > Share Project... from the context menu. Do not use "import" and select subversion.
This will begin the Share Project wizard. Select SVN as the repository type and click Next.
If you have already defined the repository location you want to store this project in, then select it in the list and click Next. Otherwise, select the Create a new repository location option and click Next. If you need to create a location then see the section on creating a new repository location in the Flexbuilder user manual for more information.
You must specify the folder name where you want to store the project. The folder name is relative to the URL of the repository location you specified in the previous step. All intermediate folders must already exist in the repository, but the final folder name must not already exist. You can use the Browse... button to select a path from within the repository. The Browse dialog also allows you to create folders, so you could use that option to create any intermediate folders. In the above example, we are going to follow the convention of storing the project in a ProjectName/trunk structure. In this example, the ProjectName folder must already exist and the trunk folder must not exist. Click Next or Finish when you are through.
The final page of the wizard is just a final confirmation page. When you click Finish, SVN will issue the mkdir command to create an empty folder in the repository. It will then checkout that folder on top of your local project. This will create the .svn folder inside your project, converting it into a valid Working Copy. Finally, the wizard will bring up the Commit Dialog so that you can commit everything into the repository. You do not have to commit everything or even anything. You may want to cancel the commit dialog and then go back to your workspace and do everything from the Team menu. For example, if you wanted to set SVN properties as part of the commit, you would want to first use the Team > Add to Version Control option and then use the Team > Set Property option etc. Once you have things the way you want them you can then perform a Team > Commit.
For more and the most up to date details on how to do this please refer to the FlexBuilder online help and go to: Workbench User Guide > Getting started > Team SVN tutorial.
