Changes for page Embedding WOFrameworks

Last modified by Gavin Eadie on 2011/07/29 18:09

From version 32.1
edited by Kieran Kelleher
on 2008/09/04 12:52
Change comment: There is no comment for this version
To version 33.1
edited by David Holt
on 2009/09/02 11:20
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.kieran
1 +XWiki.dholt
Content
... ... @@ -1,6 +1,35 @@
1 +== WOLips 3.4.x, and later, Side-note ==
2 +
3 +{{warning}}
4 +If you are updating an older project, make sure you get the latest build.xml file. Create a new project, then copy/paste the contents of the fresh build.xml file into your project's build.xml file.
5 +{{/warning}}
6 +
7 +For WOLips 3.4.x and later, while embedding is built-in, it's not enabled by default. To enable embedding:
8 +
9 +* make sure you are in the WO Explorer view
10 +* right-click your project folder, select Properties, select WOLips Deployment
11 +* check the related, if not all, options under Embed Frameworks
12 +
13 +To create a versioned/dated bundle of your app and resources:
14 +
15 +* make sure you are in the Navigator view
16 +* edit build.properties, and add:
17 +* ##build.app.name=MyApp-2009-07-14##
18 +
19 +There is a known bug with WO 5.4.x (for those not using the latest Wonder release) regarding proper linking to your web server resources within the embedded frameworks. The WOFrameworksBaseURL isn't set correctly. To do this you'll need to programmatically set this within your Application constructor:
20 +
21 +* ##setFrameworksBaseURL("/WebObjects/MyApp-2009-07-14.woa/Frameworks");##
22 +
23 +Within build.properties (I may need to be corrected on this), the best approach to linking your embedded framework's web server resources automatically is to include (however the bug noted above breaks this):
24 +
25 +* ##frameworksBaseURL=/WebObjects/$build.app.name.woa/Frameworks##
26 +
27 +And finally, there is a bug in the build.xml file that you may need to clean-up:
28 +[[http://issues.objectstyle.org/jira/browse/WOL-979]]
29 +
1 1  == Introduction ==
2 2  
3 -Below is outlined "simple embedding" concepts, however __full embedding__ **and** __split-installing__ are really recommended. This provides fully versioned self-contained bundles of both the application deployment bundle and the webserver deployment bundle. Read the docs on that technique for more **advantages**
32 +Below is outlined "simple embedding" concepts, however __full embedding__ **and** __split-installing__ are really recommended. This provides fully versioned self-contained bundles of both the application deployment bundle and the webserver deployment bundle. Read the docs on that technique for more **advantages**. This technique fully explained along with a ready-to-use ant build script is available at:
4 4  
5 5  [[Alternative Ant Build Script for Fully Embedded and Split Install Bundles]]
6 6