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 |