Skip to Content

Changes for page XcodeMigration

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

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.probert
1 +XWiki.kieran
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,92 +10,56 @@
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 -
18 18  = How to use it =
19 19  
20 -Get the project from the [[GitHub repository>>https://github.com/pascalrobert/XCodeMigration]].
21 -
22 22  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).
23 23  
24 -{{panel}}
17 +[[image:Image 1.png]]
25 25  
26 -!Image 1.png|align=center!
27 -
28 -{{/panel}}
29 -
30 30  Make sure that you are in the WOLips perspective.
31 31  
32 -{{panel}}
21 +[[image:Image 6.png]]
33 33  
34 -!Image 6.png|align=center!
35 -!Image 7.png|align=center!
23 +[[image:Image 7.png]]
36 36  
37 -{{/panel}}
25 +[[Download the tool>>^XcodeMigration.zip]] (you don't need to expand the .zip file)
38 38  
39 -Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.
27 +Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.    
40 40  
41 -{{panel}}
29 +[[image:Image 2.png]]
42 42  
43 -!Image 2.png|align=center!
44 -
45 -{{/panel}}
46 -
47 47  Select //Existings Projects into Workspace// and click //Next//.
48 48  
49 -{{panel}}
33 +[[image:Image 3.png]]
50 50  
51 -!Image 3.png|align=center!
52 -
53 -{{/panel}}
54 -
55 55  Select the location of the ZIP file with the tool and click //Finish//.
56 56  
37 +[[image:Image 4.png]]
38 +
57 57  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//.
58 58  
59 -{{panel}}
41 +[[image:Image 8.png]]
60 60  
61 -!Image 8.png|align=center!
43 +[[image:Image 9.png]]
62 62  
63 -{{/panel}}
64 -
65 -{{panel}}
66 -
67 -!Image 9.png|align=center!
68 -
69 -{{/panel}}
70 -
71 71  You should see the tool and the two templates in the //WO Package Explorer//.
72 72  
73 -{{panel}}
47 +[[image:Image 10.png]]
74 74  
75 -!Image 10.png|align=center!
76 -
77 -{{/panel}}
78 -
79 79  Open //config.xml// and change the value of the //<applicationTemplatePath>// and //<frameworkTemplatePath>// nodes so that the path points to the templates you created below.
80 80  
51 +[[image:Image 22.png]]
52 +
81 81  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
82 82  
83 83  Right-click on the //XCodeMigration.java// class and select //Run As// > //Open Run dialog...//
84 84  
85 -{{panel}}
57 +[[image:Image 12.png]]
86 86  
87 -!Image 12.png|align=center!
88 -
89 -{{/panel}}
90 -
91 91  Double-click on //Java Application//.
92 92  
93 -{{panel}}
61 +[[image:Image 13.png]]
94 94  
95 -!Image 13.png|align=center!
96 -
97 -{{/panel}}
98 -
99 99  Click on the //Arguments// tab and enter this value as a //Program arguments//.
100 100  
101 101  {{code}}
... ... @@ -104,38 +104,22 @@
104 104  
105 105  {{/code}}
106 106  
107 -{{panel}}
71 +[[image:Image 21.png]]
108 108  
109 -!Image 21.png|align=center!
110 -
111 -{{/panel}}
112 -
113 113  Click //Apply// and click //Run//.
114 114  
115 115  When it's running, you should see a output like this:
116 116  
117 -{{panel}}
77 +[[image:Image 16.png]]
118 118  
119 -!Image 16.png|align=center!
120 -
121 -{{/panel}}
122 -
123 123  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.
124 124  
125 -{{panel}}
81 +[[image:Image 17.png]]
126 126  
127 -!Image 17.png|align=center!
128 -
129 -{{/panel}}
130 -
131 131  Your converted projects will appear in the //WO Package Explorer//.
132 132  
133 -{{panel}}
85 +[[image:Image 18.png]]
134 134  
135 -!Image 18.png|align=center!
136 -
137 -{{/panel}}
138 -
139 139  Fix all frameworks dependencies and any other build errors.&nbsp; It's done.
140 140  
141 141  = FAQ =