Changes for page XcodeMigration

Summary

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

Details

Page properties

Content

...	...	@@ -1,103 +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 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]].
	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		-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).
	12	+[[image:Image 7.png]]
23	23
24		-{{panel}}
	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		-!Image 1.png|align=center!
	18	+[[image:Image 3.png]]
27	27
28		-{{/panel}}
	20	+* Create two templates, one application, the other framework
	21	+[[image:Image 8.png]]
29	29
30		-Make sure that you are in the WOLips perspective.
	23	+[[image:Image 9.png]]
31	31
32		-{{panel}}
	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;
33	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}}
	42	+[[image:Image 21.png]]
108	108
109		-!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
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.