Skip to Content

Changes for page XcodeMigration

Last modified by William Sandner on 2011/10/19 21:07
From version 24.1
edited by Pascal Robert
on 2007/12/08 23:31
Change comment: There is no comment for this version
To version 19.1
edited by William Sandner
on 2011/10/19 21:06
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.probert
1 +XWiki.wsandner
Content
... ... @@ -1,39 +1,103 @@
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).  (Alternatively, inside the Xcode tools 2.5 disk image, pbprojectdump can be found at Packages/Packages/DeveloperTools.pkg/Contents/Archive.pax.gz:/Tools/pbprojectdump)
15 +
16 +{{/note}}
17 +
7 7  = How to use it =
8 8  
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//.
20 +Get the project from the [[GitHub repository>>https://github.com/pascalrobert/XCodeMigration]].
20 20  
21 -[[image:Image 4.png]]
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).
22 22  
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//.
24 +{{panel}}
36 36  
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 +
37 37  {{code}}
38 38  
39 39  ${project_loc}/config.xml
... ... @@ -40,17 +40,40 @@
40 40  
41 41  {{/code}}
42 42  
43 -[[image:Image 21.png]]
107 +{{panel}}
44 44  
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.
109 +!Image 21.png|align=center!
53 53  
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 +
54 54  = FAQ =
55 55  
56 56  **Q.**&nbsp; I can't a //Could not find working dir for project// error when I launch my converted application.