Skip to Content

Changes for page XcodeMigration

Last modified by William Sandner on 2011/10/19 21:07
From version 31.1
edited by Kieran Kelleher
on 2007/12/20 22:52
Change comment: There is no comment for this version
To version 32.1
edited by Pascal Robert
on 2011/03/27 10:25
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.kieran
1 +XWiki.probert
Content
... ... @@ -1,6 +1,6 @@
1 1  {{toc}}{{/toc}}
2 2  
3 -= Introduction  =
3 += Introduction =
4 4  
5 5  XcodeMigration is a tool written by [[Pascal Robert>>~~probert]]to help you migrate multiple WebObjects projects from Xcode to Eclipse/WOLips.  If you have complex or many projects to convert, this is the tool to use.  The tool is written in Java and is a Eclipse project, so you will need to import the project into Eclipse first (you need a functionnal WOLips installation to be able to import the tool). 
6 6  
... ... @@ -10,56 +10,104 @@
10 10  
11 11  {{/info}}
12 12  
13 +{{note}}
14 +XcodeMigration is using the tool _pbprojectdump_ which is no longer present in the Xcode 3 bundle. You need to install Xcode 2.5 to get access to _pbprojectdump_ (you can copy it from another machine too).
15 +
16 +{{/note}}
17 +
13 13  = How to use it =
14 14  
20 +Get the project from the [[GitHub repository>>https://github.com/pascalrobert/XCodeMigration]].
21 +
15 15  If you want to convert your Java classes from MacRoman to UTF-8, make sure your Eclipse workspace is in UTF-8 (the default is MacRoman).
16 16  
17 -[[image:Image 1.png]]
24 +{{panel}}
18 18  
26 +!Image 1.png|align=center!
27 +
28 +{{/panel}}
29 +
19 19  Make sure that you are in the WOLips perspective.
20 20  
21 -[[image:Image 6.png]]
32 +{{panel}}
22 22  
23 -[[image:Image 7.png]]
34 +!Image 6.png|align=center!
35 +!Image 7.png|align=center!
24 24  
25 -[[Download the tool>>^XcodeMigration.zip]] (you don't need to expand the .zip file)
37 +{{/panel}}
26 26  
27 -Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.    
39 +Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.
28 28  
29 -[[image:Image 2.png]]
41 +{{panel}}
30 30  
43 +!Image 2.png|align=center!
44 +
45 +{{/panel}}
46 +
31 31  Select //Existings Projects into Workspace// and click //Next//.
32 32  
33 -[[image:Image 3.png]]
49 +{{panel}}
34 34  
51 +!Image 3.png|align=center!
52 +
53 +{{/panel}}
54 +
35 35  Select the location of the ZIP file with the tool and click //Finish//.
36 36  
37 -[[image:Image 4.png]]
57 +{{panel}}
38 38  
59 +!Image 4.png|align=center!
60 +
61 +{{/panel}}
62 +
39 39  The tool needs two projects templates, one of them is a application template, the other a framework template.  So you need to create a //WebObjects Application// and a //WebObjects Framework//.
40 40  
41 -[[image:Image 8.png]]
65 +{{panel}}
42 42  
43 -[[image:Image 9.png]]
67 +!Image 8.png|align=center!
44 44  
69 +{{/panel}}
70 +
71 +{{panel}}
72 +
73 +!Image 9.png|align=center!
74 +
75 +{{/panel}}
76 +
45 45  You should see the tool and the two templates in the //WO Package Explorer//.
46 46  
47 -[[image:Image 10.png]]
79 +{{panel}}
48 48  
81 +!Image 10.png|align=center!
82 +
83 +{{/panel}}
84 +
49 49  Open //config.xml// and change the value of the //<applicationTemplatePath>// and //<frameworkTemplatePath>// nodes so that the path points to the templates you created below.
50 50  
51 -[[image:Image 22.png]]
87 +{{panel}}
52 52  
89 +!Image 22.png|align=center!
90 +
91 +{{/panel}}
92 +
53 53  For each project that you want to import, you need the a //<project>// node.&nbsp; //<path>// is the file system path to the Xcode project, //<name>// is the project name, minus .xcodeproj
54 54  
55 55  Right-click on the //XCodeMigration.java// class and select //Run As// > //Open Run dialog...//
56 56  
57 -[[image:Image 12.png]]
97 +{{panel}}
58 58  
99 +!Image 12.png|align=center!
100 +
101 +{{/panel}}
102 +
59 59  Double-click on //Java Application//.
60 60  
61 -[[image:Image 13.png]]
105 +{{panel}}
62 62  
107 +!Image 13.png|align=center!
108 +
109 +{{/panel}}
110 +
63 63  Click on the //Arguments// tab and enter this value as a //Program arguments//.
64 64  
65 65  {{code}}
... ... @@ -68,22 +68,38 @@
68 68  
69 69  {{/code}}
70 70  
71 -[[image:Image 21.png]]
119 +{{panel}}
72 72  
121 +!Image 21.png|align=center!
122 +
123 +{{/panel}}
124 +
73 73  Click //Apply// and click //Run//.
74 74  
75 75  When it's running, you should see a output like this:
76 76  
77 -[[image:Image 16.png]]
129 +{{panel}}
78 78  
131 +!Image 16.png|align=center!
132 +
133 +{{/panel}}
134 +
79 79  To import the converted projects, open //File// > //Import// > //Existings projects into workspace//.&nbsp; Click //Next//. Select //Select Root Directory// and browse to ///tmp/migrations//.&nbsp; You should see the list of projects that you converted.
80 80  
81 -[[image:Image 17.png]]
137 +{{panel}}
82 82  
139 +!Image 17.png|align=center!
140 +
141 +{{/panel}}
142 +
83 83  Your converted projects will appear in the //WO Package Explorer//.
84 84  
85 -[[image:Image 18.png]]
145 +{{panel}}
86 86  
147 +!Image 18.png|align=center!
148 +
149 +{{/panel}}
150 +
87 87  Fix all frameworks dependencies and any other build errors.&nbsp; It's done.
88 88  
89 89  = FAQ =