Changes for page XcodeMigration

Last modified by William Sandner on 2011/10/19 21:07

From version 17.1
edited by Pascal Robert
on 2011/03/27 10:27
Change comment: There is no comment for this version
To version 24.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,103 +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 -Get the project from the [[GitHub repository>>https://github.com/pascalrobert/XCodeMigration]].
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 -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).
21 +[[image:Image 4.png]]
23 23  
24 -{{panel}}
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 -!Image 1.png|align=center!
27 -
28 -{{/panel}}
29 -
30 -Make sure that you are in the WOLips perspective.
31 -
32 -{{panel}}
33 -
34 -!Image 6.png|align=center!
35 -!Image 7.png|align=center!
36 -
37 -{{/panel}}
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 -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//.
58 -
59 -{{panel}}
60 -
61 -!Image 8.png|align=center!
62 -
63 -{{/panel}}
64 -
65 -{{panel}}
66 -
67 -!Image 9.png|align=center!
68 -
69 -{{/panel}}
70 -
71 -You should see the tool and the two templates in the //WO Package Explorer//.
72 -
73 -{{panel}}
74 -
75 -!Image 10.png|align=center!
76 -
77 -{{/panel}}
78 -
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 -
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 -
83 -Right-click on the //XCodeMigration.java// class and select //Run As// > //Open Run dialog...//
84 -
85 -{{panel}}
86 -
87 -!Image 12.png|align=center!
88 -
89 -{{/panel}}
90 -
91 -Double-click on //Java Application//.
92 -
93 -{{panel}}
94 -
95 -!Image 13.png|align=center!
96 -
97 -{{/panel}}
98 -
99 -Click on the //Arguments// tab and enter this value as a //Program arguments//.
100 -
101 101  {{code}}
102 102  
103 103  ${project_loc}/config.xml
... ... @@ -104,40 +104,17 @@
104 104  
105 105  {{/code}}
106 106  
107 -{{panel}}
43 +[[image:Image 21.png]]
108 108  
109 -!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.
110 110  
111 -{{/panel}}
112 -
113 -Click //Apply// and click //Run//.
114 -
115 -When it's running, you should see a output like this:
116 -
117 -{{panel}}
118 -
119 -!Image 16.png|align=center!
120 -
121 -{{/panel}}
122 -
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 -
125 -{{panel}}
126 -
127 -!Image 17.png|align=center!
128 -
129 -{{/panel}}
130 -
131 -Your converted projects will appear in the //WO Package Explorer//.
132 -
133 -{{panel}}
134 -
135 -!Image 18.png|align=center!
136 -
137 -{{/panel}}
138 -
139 -Fix all frameworks dependencies and any other build errors.&nbsp; It's done.
140 -
141 141  = FAQ =
142 142  
143 143  **Q.**&nbsp; I can't a //Could not find working dir for project// error when I launch my converted application.