Changes for page XcodeMigration

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,115 +1,38 @@
1		-{{toc}}{{/toc}}
	1	+= Introduction  =
2	2
3		-= Introduction =
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 it over 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).
	7	+* 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).
	8	+[[image:Image 1.png]]
	9	+* Make sure that you are in the WOLips perspective
	10	+[[image:Image 6.png]]
21	21
22		-{{panel}}
	12	+[[image:Image 7.png]]
23	23
24		-!Image 1.png|align=center!
	14	+* Download the tool (you don't need to expand the .zip file)
	15	+* Import the XcodeMigration tool into Eclipse, by selecting File > Import > Existings projects into workspace.  Next.  select archive
	16	+[[image:Image 2.png]]
25	25
26		-{{/panel}}
	18	+[[image:Image 3.png]]
27	27
28		-Make sure that you are in the WOLips perspective.
	20	+* Create two templates, one application, the other framework
	21	+[[image:Image 8.png]]
29	29
30		-{{panel}}
	23	+[[image:Image 9.png]]
31	31
32		-!Image 6.png|align=center!
33		-!Image 7.png|align=center!
	25	+* should see 3 projects
	26	+[[image:Image 10.png]]
	27	+* open config.xml and change <applicationTemplatePath> and <frameworkTemplatePath>
	28	+[[image:Image 11.png]]
	29	+* 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
	30	+* open the Run dialog
	31	+[[image:Image 12.png]]
	32	+* double-click on Java Application
	33	+[[image:Image 13.png]]
	34	+* click on the arguments tab and enter this value as a program arguments&nbsp;
34	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}}
	42	+[[image:Image 21.png]]
120	120
121		-!Image 21.png|align=center!
	44	+* click apply and run
	45	+* when it's running, you should get a output like this
	46	+[[image:Image 16.png]]
	47	+* to import the converted projects, open File > Import > Existings projects into workspace.&nbsp; Next. select root directory
	48	+[[image:Image 17.png]]
	49	+* your converted projects will appear in the package explorer
	50	+[[image:Image 18.png]]
	51	+* fix all frameworks dependencies and you're 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.