Changes for page XcodeMigration

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

From version 50.1
edited by jacky_1970
on 2009/01/23 09:13
Change comment: There is no comment for this version
To version 52.1
edited by William Sandner
on 2011/10/19 21:07
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.jacky_1970
1 +XWiki.wsandner
Content
... ... @@ -1,6 +1,6 @@
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  
... ... @@ -11,60 +11,93 @@
11 11  {{/info}}
12 12  
13 13  {{note}}
14 -XcodeMigration is using the tool _pbprojectdump_ which is no longer present in the Xcode 3 bundle.
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 15  
16 +Alternatively, inside the Xcode tools 2.5 disk image, pbprojectdump can be found at Packages/Packages/DeveloperTools.pkg/Contents/Archive.pax.gz:/Tools/pbprojectdump
17 +
16 16  {{/note}}
17 17  
18 18  = How to use it =
19 19  
22 +Get the project from the [[GitHub repository>>https://github.com/pascalrobert/XCodeMigration]].
23 +
20 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).
21 21  
22 -[[image:Image 1.png]]
26 +{{panel}}
23 23  
28 +!Image 1.png|align=center!
29 +
30 +{{/panel}}
31 +
24 24  Make sure that you are in the WOLips perspective.
25 25  
26 -[[image:Image 6.png]]
34 +{{panel}}
27 27  
28 -[[image:Image 7.png]]
36 +!Image 6.png|align=center!
37 +!Image 7.png|align=center!
29 29  
30 -[[Download the tool>>^XcodeMigration.zip]] (you don't need to expand the .zip file)
39 +{{/panel}}
31 31  
32 -Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.    
41 +Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.
33 33  
34 -[[image:Image 2.png]]
43 +{{panel}}
35 35  
45 +!Image 2.png|align=center!
46 +
47 +{{/panel}}
48 +
36 36  Select //Existings Projects into Workspace// and click //Next//.
37 37  
38 -[[image:Image 3.png]]
51 +{{panel}}
39 39  
40 -Select the location of the ZIP file with the tool and click //Finish//.
53 +!Image 3.png|align=center!
41 41  
42 -[[image:Image 4.png]]
55 +{{/panel}}
43 43  
57 +Select the location of the ZIP file with the tool and click //Finish//.
58 +
44 44  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//.
45 45  
46 -[[image:Image 8.png]]
61 +{{panel}}
47 47  
48 -[[image:Image 9.png]]
63 +!Image 8.png|align=center!
49 49  
65 +{{/panel}}
66 +
67 +{{panel}}
68 +
69 +!Image 9.png|align=center!
70 +
71 +{{/panel}}
72 +
50 50  You should see the tool and the two templates in the //WO Package Explorer//.
51 51  
52 -[[image:Image 10.png]]
75 +{{panel}}
53 53  
54 -Open //config.xml// and change the value of the //<applicationTemplatePath>// and //<frameworkTemplatePath>// nodes so that the path points to the templates you created below.
77 +!Image 10.png|align=center!
55 55  
56 -[[image:Image 22.png]]
79 +{{/panel}}
57 57  
81 +Open //config.xml// and change the value of the //<applicationTemplatePath>// and //<frameworkTemplatePath>// nodes so that the path points to the templates you created below.
82 +
58 58  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
59 59  
60 60  Right-click on the //XCodeMigration.java// class and select //Run As// > //Open Run dialog...//
61 61  
62 -[[image:Image 12.png]]
87 +{{panel}}
63 63  
89 +!Image 12.png|align=center!
90 +
91 +{{/panel}}
92 +
64 64  Double-click on //Java Application//.
65 65  
66 -[[image:Image 13.png]]
95 +{{panel}}
67 67  
97 +!Image 13.png|align=center!
98 +
99 +{{/panel}}
100 +
68 68  Click on the //Arguments// tab and enter this value as a //Program arguments//.
69 69  
70 70  {{code}}
... ... @@ -73,22 +73,38 @@
73 73  
74 74  {{/code}}
75 75  
76 -[[image:Image 21.png]]
109 +{{panel}}
77 77  
111 +!Image 21.png|align=center!
112 +
113 +{{/panel}}
114 +
78 78  Click //Apply// and click //Run//.
79 79  
80 80  When it's running, you should see a output like this:
81 81  
82 -[[image:Image 16.png]]
119 +{{panel}}
83 83  
121 +!Image 16.png|align=center!
122 +
123 +{{/panel}}
124 +
84 84  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.
85 85  
86 -[[image:Image 17.png]]
127 +{{panel}}
87 87  
129 +!Image 17.png|align=center!
130 +
131 +{{/panel}}
132 +
88 88  Your converted projects will appear in the //WO Package Explorer//.
89 89  
90 -[[image:Image 18.png]]
135 +{{panel}}
91 91  
137 +!Image 18.png|align=center!
138 +
139 +{{/panel}}
140 +
92 92  Fix all frameworks dependencies and any other build errors.&nbsp; It's done.
93 93  
94 94  = FAQ =