Changes for page XcodeMigration

Summary

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

Details

Page properties

Content

...	...	@@ -1,38 +1,115 @@
1		-= Introduction  =
	1	+{{toc}}{{/toc}}
2	2
	3	+= Introduction =
	4	+
3	3	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). 
4	4
	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	+
5	5	= How to use it =
6	6
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]]
	20	+Get the project from the [[GitHub repository>>https://github.com/pascalrobert/XCodeMigration]].
11	11
12		-[[image:Image 7.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).
13	13
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]]
	24	+{{panel}}
17	17
18		-[[image:Image 3.png]]
	26	+!Image 1.png|align=center!
19	19
20		-* Create two templates, one application, the other framework
21		-[[image:Image 8.png]]
	28	+{{/panel}}
22	22
23		-[[image:Image 9.png]]
	30	+Make sure that you are in the WOLips perspective.
24	24
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;
	32	+{{panel}}
35	35
	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	+{{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	+
36	36	{{code}}
37	37
38	38	${project_loc}/config.xml
...	...	@@ -39,17 +39,40 @@
39	39
40	40	{{/code}}
41	41
42		-[[image:Image 21.png]]
	119	+{{panel}}
43	43
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
	121	+!Image 21.png|align=center!
52	52
	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	+
53	53	= FAQ =
54	54
55	55	**Q.**&nbsp; I can't a //Could not find working dir for project// error when I launch my converted application.