| OLD | NEW |
| (Empty) |
| 1 Building the Dart Editor RCP distro | |
| 2 | |
| 3 Assuming Dart sources are checked out, there are four steps to building | |
| 4 Dart Editor. This process is only required because the RCP export wizard | |
| 5 cannot handle linked resources. The steps are: | |
| 6 | |
| 7 1. Copy all the sources into a working directory. | |
| 8 2. Build an Eclipse workspace from the working directory. | |
| 9 3. Create the distro using Eclipse's Product export wizard. | |
| 10 4. Rename the export diretory and compress it into an archive file. | |
| 11 | |
| 12 Step 1 is automated by the rcpinit.sh bash shell script, in the same | |
| 13 directory as this README. It also uses emptyDartWorkspace.zip (in the | |
| 14 same directory) to initialize step 2. | |
| 15 | |
| 16 Step 2 is completed manually, as is step 3. Step 4 is optional. | |
| 17 | |
| 18 It is recommended that all files in this build directory be copied into the | |
| 19 parent directory of TRUNK (as defined in rcpinit.sh). | |
| 20 | |
| 21 To begin, make sure the Dart plugin and feature sources are checked out from | |
| 22 SVN. Edit rcpinit.sh to define the location of the TRUNK directory that was | |
| 23 checked out. Also checkout the usage profile plugin and feature from perforce. | |
| 24 Define that directory in rcpinit.sh as GDT_PROF. You only the the usage | |
| 25 profiler, not all of GPE. | |
| 26 | |
| 27 From a terminal emulator, cd to the directory containing the customized | |
| 28 rcpinit.sh and execute it. That completes step 1, and initializes step 2. | |
| 29 Note that a new directory called workDart is created. It contains a copy | |
| 30 of all the sources needed to build the distro. | |
| 31 | |
| 32 Start up Eclipse. Switch workspace to the workDart directory created by | |
| 33 rcpinit.sh. Import the existing projects into Eclipse, but do not copy them. | |
| 34 | |
| 35 Open the dart_feature.product definition (in com.google.dart.tools.deploy) in | |
| 36 the Product Editor (double-click it). Find the "Exporting" section in the lower | |
| 37 right, and click the "Eclipse Product export wizard" link to start the wizard. | |
| 38 Select an output directory. It should be empty to start; re-using a directory | |
| 39 does not clear out old stuff and can cause problems. You can uncheck the | |
| 40 "Generate metadata repository" option. Allow the wizard to finish. | |
| 41 | |
| 42 In the selected output directory, rename the "eclipse" directory to "darttools" | |
| 43 then compress it for distribution. Finally, test the result. Reversing those | |
| 44 steps seems logical, but testing creates a lot of files and directories that | |
| 45 should not be distributed. To test the distro, import the Total app, build it, | |
| 46 and run it. Try a few editor functions like code completion and hyperlinking. | |
| 47 | |
| 48 Note: To get the usage profiler without getting all of GPE you can use a two | |
| 49 stage checkout. Log into your Ubiquity instance, create a new directory, cd | |
| 50 into it and do: | |
| 51 | |
| 52 git5 start trunk google3/third_party/java/google_plugin_eclipse/opensource/trunk
/plugins/com.google.gdt.eclipse.usageprofiler | |
| 53 git5 track google3/third_party/java/google_plugin_eclipse/opensource/trunk/featu
res/com.google.gdt.eclipse.usageprofiler.feature | |
| 54 | |
| 55 Then use 'git clone' to make that directory available to your build machine. | |
| 56 In rcpinit.sh, change GDT_PROF to point to the cloned directory. Of course, | |
| 57 you only need to clone it if you are building on a Mac. | |
| 58 | |
| 59 Note: These instructions only create an executable that runs on the same | |
| 60 platform as the build box. Cross-platform building requires some additional | |
| 61 work, including downloading the delta pack from eclipse.org. | |
| 62 | |
| 63 There may be useful info in the RCP How-to: | |
| 64 | |
| 65 http://wiki.eclipse.org/Eclipse_RCP_How-to | |
| 66 | |
| OLD | NEW |