Skip to Content

Changes for page XcodeMigration

Last modified by William Sandner on 2011/10/19 21:07
From version 35.1
edited by Pascal Robert
on 2010/02/16 20:35
Change comment: There is no comment for this version
To version 25.1
edited by Pascal Robert
on 2007/12/08 23:31
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,115 +1,39 @@
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  
7 -{{info title="Short video showing XCode project conversion"}}
8 -
9 -* [Converting XCode Projects to Eclipse Dev Tools|http://www.wocommunity.org/podcasts/Converting_Xcode_projects.mov]
10 -
11 -{{/info}}
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 -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).
9 +* 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).
10 +[[image:Image 1.png]]
11 +* Make sure that you are in the WOLips perspective.
12 +[[image:Image 6.png]]
13 +[[image:Image 7.png]]
14 +* Download the tool (you don't need to expand the .zip file)
15 +* Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.    
16 +[[image:Image 2.png]]
17 +* Select //Existings Projects into Workspace// and click //Next//.
18 +[[image:Image 3.png]]
19 +* Select the location of the ZIP file with the tool and click //Finish//.
21 21  
22 -{{panel}}
21 +[[image:Image 4.png]]
23 23  
24 -!Image 1.png|align=center!
23 +* 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//.
24 +[[image:Image 8.png]]
25 +[[image:Image 9.png]]
26 +* You should see the tool and the two templates in the //WO Package Explorer//.
27 +[[image:Image 10.png]]
28 +* Open //config.xml// and change the value of the //<applicationTemplatePath>// and //<frameworkTemplatePath>// nodes so that the path points to the templates you created below.
29 +[[image:Image 22.png]]
30 +* 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
31 +* Right-click on the //XCodeMigration.java// class and select //Run As// > //Open Run dialog...//
32 +[[image:Image 12.png]]
33 +* Double-click on //Java Application//.
34 +[[image:Image 13.png]]
35 +* Click on the //Arguments// tab and enter this value as a //Program arguments//.
25 25  
26 -{{/panel}}
27 -
28 -Make sure that you are in the WOLips perspective.
29 -
30 -{{panel}}
31 -
32 -!Image 6.png|align=center!
33 -!Image 7.png|align=center!
34 -
35 -{{/panel}}
36 -
37 -[[Download the tool>>^XcodeMigration.zip]] (you don't need to expand the .zip file). You can also get it from a [[Subversion repository>>https://services.wocommunity.org/probert/XCodeMigration/]].
38 -
39 -Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.
40 -
41 -{{panel}}
42 -
43 -!Image 2.png|align=center!
44 -
45 -{{/panel}}
46 -
47 -Select //Existings Projects into Workspace// and click //Next//.
48 -
49 -{{panel}}
50 -
51 -!Image 3.png|align=center!
52 -
53 -{{/panel}}
54 -
55 -Select the location of the ZIP file with the tool and click //Finish//.
56 -
57 -{{panel}}
58 -
59 -!Image 4.png|align=center!
60 -
61 -{{/panel}}
62 -
63 -The tool needs two projects templates, one of them is a application template, the other a framework template.&nbsp; So you need to create a //WebObjects Application// and a //WebObjects Framework//.
64 -
65 -{{panel}}
66 -
67 -!Image 8.png|align=center!
68 -
69 -{{/panel}}
70 -
71 -{{panel}}
72 -
73 -!Image 9.png|align=center!
74 -
75 -{{/panel}}
76 -
77 -You should see the tool and the two templates in the //WO Package Explorer//.
78 -
79 -{{panel}}
80 -
81 -!Image 10.png|align=center!
82 -
83 -{{/panel}}
84 -
85 -Open //config.xml// and change the value of the //<applicationTemplatePath>// and //<frameworkTemplatePath>// nodes so that the path points to the templates you created below.
86 -
87 -{{panel}}
88 -
89 -!Image 22.png|align=center!
90 -
91 -{{/panel}}
92 -
93 -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
94 -
95 -Right-click on the //XCodeMigration.java// class and select //Run As// > //Open Run dialog...//
96 -
97 -{{panel}}
98 -
99 -!Image 12.png|align=center!
100 -
101 -{{/panel}}
102 -
103 -Double-click on //Java Application//.
104 -
105 -{{panel}}
106 -
107 -!Image 13.png|align=center!
108 -
109 -{{/panel}}
110 -
111 -Click on the //Arguments// tab and enter this value as a //Program arguments//.
112 -
113 113  {{code}}
114 114  
115 115  ${project_loc}/config.xml
... ... @@ -116,40 +116,17 @@
116 116  
117 117  {{/code}}
118 118  
119 -{{panel}}
43 +[[image:Image 21.png]]
120 120  
121 -!Image 21.png|align=center!
45 +* Click //Apply// and click //Run//.
46 +* When it's running, you should see a output like this:
47 +[[image:Image 16.png]]
48 +* 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.
49 +[[image:Image 17.png]]
50 +* Your converted projects will appear in the //WO Package Explorer//.
51 +[[image:Image 18.png]]
52 +* Fix all frameworks dependencies and any other build errors.&nbsp; It's done.
122 122  
123 -{{/panel}}
124 -
125 -Click //Apply// and click //Run//.
126 -
127 -When it's running, you should see a output like this:
128 -
129 -{{panel}}
130 -
131 -!Image 16.png|align=center!
132 -
133 -{{/panel}}
134 -
135 -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.
136 -
137 -{{panel}}
138 -
139 -!Image 17.png|align=center!
140 -
141 -{{/panel}}
142 -
143 -Your converted projects will appear in the //WO Package Explorer//.
144 -
145 -{{panel}}
146 -
147 -!Image 18.png|align=center!
148 -
149 -{{/panel}}
150 -
151 -Fix all frameworks dependencies and any other build errors.&nbsp; It's done.
152 -
153 153  = FAQ =
154 154  
155 155  **Q.**&nbsp; I can't a //Could not find working dir for project// error when I launch my converted application.