Skip to Content

Changes for page XcodeMigration

Last modified by William Sandner on 2011/10/19 21:07
From version 52.1
edited by William Sandner
on 2011/10/19 21:07
Change comment: There is no comment for this version
To version 55.1
edited by William Sandner
on 2023/11/13 11:55
Change comment: Renamed from xwiki:WOL.XcodeMigration

Summary

Details

Page properties
Parent
... ... @@ -1,0 +1,1 @@
1 +Upgrading to WOLips from Xcode or Project Builder
Content
... ... @@ -1,101 +1,80 @@
1 -{{toc}}{{/toc}}
1 +{{toc/}}
2 2  
3 3  = Introduction =
4 4  
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). 
5 +XcodeMigration is a tool written by {{mention reference="XWiki.probert" style="FULL_NAME" anchor="XWiki-probert-QkZxc"/}}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 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 -
8 +* [[Converting XCode Projects to Eclipse Dev Tools>>url:http://www.wocommunity.org/podcasts/Converting_Xcode_projects.mov||shape="rect"]]
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. You need to install Xcode 2.5 to get access to _pbprojectdump_ (you can copy it from another machine too).  \\
12 +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 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 -
18 18  {{/note}}
19 19  
20 20  = How to use it =
21 21  
22 -Get the project from the [[GitHub repository>>https://github.com/pascalrobert/XCodeMigration]].
19 +Get the project from the [[GitHub repository>>url:https://github.com/pascalrobert/XCodeMigration||shape="rect"]].
23 23  
24 24  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).
25 25  
26 26  {{panel}}
27 -
28 -!Image 1.png|align=center!
29 -
24 +[[image:attach:Image 1.png]]
30 30  {{/panel}}
31 31  
32 32  Make sure that you are in the WOLips perspective.
33 33  
34 34  {{panel}}
35 -
36 -!Image 6.png|align=center!
37 -!Image 7.png|align=center!
38 -
30 +[[image:attach:Image 6.png]]
31 +[[image:attach:Image 7.png]]
39 39  {{/panel}}
40 40  
41 -Import the XcodeMigration tool into Eclipse, by selecting //File// > //Import//.
34 +Import the XcodeMigration tool into Eclipse, by selecting //File// -> //Import//.
42 42  
43 43  {{panel}}
44 -
45 -!Image 2.png|align=center!
46 -
37 +[[image:attach:Image 2.png]]
47 47  {{/panel}}
48 48  
49 49  Select //Existings Projects into Workspace// and click //Next//.
50 50  
51 51  {{panel}}
52 -
53 -!Image 3.png|align=center!
54 -
43 +[[image:attach:Image 3.png]]
55 55  {{/panel}}
56 56  
57 57  Select the location of the ZIP file with the tool and click //Finish//.
58 58  
59 -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//.
48 +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//.
60 60  
61 61  {{panel}}
62 -
63 -!Image 8.png|align=center!
64 -
51 +[[image:attach:Image 8.png]]
65 65  {{/panel}}
66 66  
67 67  {{panel}}
68 -
69 -!Image 9.png|align=center!
70 -
55 +[[image:attach:Image 9.png]]
71 71  {{/panel}}
72 72  
73 73  You should see the tool and the two templates in the //WO Package Explorer//.
74 74  
75 75  {{panel}}
76 -
77 -!Image 10.png|align=center!
78 -
61 +[[image:attach:Image 10.png]]
79 79  {{/panel}}
80 80  
81 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 82  
83 -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
66 +For each project that you want to import, you need the a //<project>// node.  //<path>// is the file system path to the Xcode project, //<name>// is the project name, minus .xcodeproj
84 84  
85 -Right-click on the //XCodeMigration.java// class and select //Run As// > //Open Run dialog...//
68 +Right-click on the //XCodeMigration.java// class and select //Run As// -> //Open Run dialog...//
86 86  
87 87  {{panel}}
88 -
89 -!Image 12.png|align=center!
90 -
71 +[[image:attach:Image 12.png]]
91 91  {{/panel}}
92 92  
93 93  Double-click on //Java Application//.
94 94  
95 95  {{panel}}
96 -
97 -!Image 13.png|align=center!
98 -
77 +[[image:attach:Image 13.png]]
99 99  {{/panel}}
100 100  
101 101  Click on the //Arguments// tab and enter this value as a //Program arguments//.
... ... @@ -107,9 +107,7 @@
107 107  {{/code}}
108 108  
109 109  {{panel}}
110 -
111 -!Image 21.png|align=center!
112 -
89 +[[image:attach:Image 21.png]]
113 113  {{/panel}}
114 114  
115 115  Click //Apply// and click //Run//.
... ... @@ -117,36 +117,30 @@
117 117  When it's running, you should see a output like this:
118 118  
119 119  {{panel}}
120 -
121 -!Image 16.png|align=center!
122 -
97 +[[image:attach:Image 16.png]]
123 123  {{/panel}}
124 124  
125 -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.
100 +To import the converted projects, open //File// -> //Import// -> //Existings projects into workspace//.  Click //Next//. Select //Select Root Directory// and browse to ///tmp/migrations//.  You should see the list of projects that you converted.
126 126  
127 127  {{panel}}
128 -
129 -!Image 17.png|align=center!
130 -
103 +[[image:attach:Image 17.png]]
131 131  {{/panel}}
132 132  
133 133  Your converted projects will appear in the //WO Package Explorer//.
134 134  
135 135  {{panel}}
136 -
137 -!Image 18.png|align=center!
138 -
109 +[[image:attach:Image 18.png]]
139 139  {{/panel}}
140 140  
141 -Fix all frameworks dependencies and any other build errors.&nbsp; It's done.
112 +Fix all frameworks dependencies and any other build errors.  It's done.
142 142  
143 143  = FAQ =
144 144  
145 -**Q.**&nbsp; I can't a //Could not find working dir for project// error when I launch my converted application.
146 -**A.**&nbsp; Make sure that, in //config.xml//, //<applicationTemplatePath>// is set to a WO application instead of a WO framework.
116 +**Q.**  I can't a //Could not find working dir for project// error when I launch my converted application.
117 + **A.**  Make sure that, in //config.xml//, //<applicationTemplatePath>// is set to a WO application instead of a WO framework.
147 147  
148 -**Q.**&nbsp; Some of my resources are missing or in the wrong folder.
149 -**A.**&nbsp; The tool detect files that should be marked as //Resources// by file extension or name. If a file is not a Java class or one of the file type in the //Resources// list, the file will be move to the //WebServerResources// folder instead. You just have to move the files to the Resources folder when needed. If you have file types who should be detected as resources, you can add the needed code in the //copyFiles// method.
119 +**Q.**  Some of my resources are missing or in the wrong folder.
120 + **A.**  The tool detect files that should be marked as //Resources// by file extension or name. If a file is not a Java class or one of the file type in the //Resources// list, the file will be move to the //WebServerResources// folder instead. You just have to move the files to the Resources folder when needed. If you have file types who should be detected as resources, you can add the needed code in the //copyFiles// method.
150 150  
151 -**Q.**&nbsp; My application is localized and the content in the components are displaying the wrong caracters.
152 -**A.**&nbsp; If you set the //<convertToUTF8>// node to true, your Java classes will be converted from MacRoman to UTF-8, but the tool will NOT modify the .woo file so that they use UTF-8. Either you stay in MacRoman and change the value of //<convertToUTF8>// to //false//, or you will have to modify your components so that they use UTF-8.
122 +**Q.**  My application is localized and the content in the components are displaying the wrong caracters.
123 + **A.**  If you set the //<convertToUTF8>// node to true, your Java classes will be converted from MacRoman to UTF-8, but the tool will NOT modify the .woo file so that they use UTF-8. Either you stay in MacRoman and change the value of //<convertToUTF8>// to //false//, or you will have to modify your components so that they use UTF-8.
Image 1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +73.7 KB
Content
Image 10.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +22.4 KB
Content
Image 11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +33.7 KB
Content
Image 12.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +113.0 KB
Content
Image 13.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +50.5 KB
Content
Image 14.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +46.4 KB
Content
Image 16.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +25.9 KB
Content
Image 17.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +46.1 KB
Content
Image 18.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +14.0 KB
Content
Image 2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +46.6 KB
Content
Image 21.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +89.1 KB
Content
Image 3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +25.1 KB
Content
Image 6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +16.8 KB
Content
Image 7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +27.7 KB
Content
Image 8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +25.1 KB
Content
Image 9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +42.9 KB
Content