Changes between Version 19 and Version 20 of OvaReleaseNote-1.0.1-RC2

Timestamp:

04/10/12 06:04:02 (14 months ago)

Author:

paul

Comment:

--

OvaReleaseNote-1.0.1-RC2

@@ -114 +114 @@
 == 4. The New Build Process ==
 
-A new build process has been introduced in 1.0.1 RC2 to support a degree of customised building of the plugin SWFs and OVA for AS3 library SWC to help reduce the overall size of the compiled file.
-
-Accordingly, the OVA for AS3, OVA for Flowplayer and OVA for JW5 build processes have been moved completely to Ant and the old "shell script" build files (e.g. build.sh etc.) have been removed.
-
-The new Ant build files are always located in the `build` directory of the distribution package as illustrated by the directory structure below:
+A new build process has been introduced in 1.0.1 RC2 to support a degree of customisation when building the OVA library or player related plugin SWFs. The size of the resulting SWF can be more effectively controlled via the new build process.
+
+As part of this, the OVA for AS3, OVA for Flowplayer and OVA for JW5 build processes have been moved completely to Ant and the old "shell script" build files (e.g. build.sh etc.) have been removed.
+
+The new Ant build files are always located in the `build` directory of each distribution package:
 
 {{{
@@ -143 +143 @@
 === 4.1 Installing the OVA Source Files ===
 
-By default, the OVA build process assumes that the source for all OVA products will be placed in the same `workspace`. For example, if OVA for AS3, OVA for JW5 and OVA for Flowplayer were all to be built, the following directory structure is assumed by the build files:
+By default, the OVA build process assumes that the source for all OVA products will be placed relative to each other in the same `workspace`. For example, if OVA for AS3, OVA for JW5 and OVA for Flowplayer were all to be built, the following directory structure is assumed by the build files:
 
 {{{
@@ -164 +164 @@
 }}}
 
-While it is possible to vary the locations of the packages and customise the build files accordingly (specifically the `build.properties` files in each distribution), the default structure is recommended.
-
-To install the source code, either:
+While it is possible to vary the locations of the packages and customise the build files accordingly (specifically the `build.properties` files in each distribution), the default structure is recommended as it means that minimal changes will be required to the `build.properties` files that accompany each `build.xml` ant script.
+
+To install the source code for an OVA product either:
 
    * Download the required distribution package from the "[wiki:OvaDownload Download the Latest]" page or
    * Check out the source code directly from the OVA Subversion repository (see these [http://developer.longtailvideo.com/ova/wiki/OvaSubversionAccess instructions] for details on how to do that)
 
-By default, the OVA for AS3 package is not required to build either OVA for Flowplayer or OVA for JW5 - the default build commands use the pre-built OVA for AS3 Library included with the OVA for JW5 or OVA for Flowplayer packages. However, if you wish to customise the build and reduce the size of the OVA plugin SWF, you will need to also install the OVA for AS3 package and build the OVA SWC separately.
+By default, the OVA for AS3 package is not required to build either OVA for Flowplayer or OVA for JW5 plugins SWFs - the default build commands use the pre-built OVA for AS3 library that is included with the OVA for JW5 or OVA for Flowplayer packages. However, if you wish to customise the build and reduce the size of the OVA plugin SWF, you will need to also install the OVA for AS3 package and build the OVA SWC separately.
 
 === 4.2 Building OVA for AS3 ===
 
+Three forms of the OVA SWC can now be built:
+
+   * A `debug` version that includes all of the standard OVA debug output (this is the default form)
+   * A `release` version that excludes the debug output and associated library functions
+   * A `minimal` version that excludes prepackaged button resources, debug, custom ad server functionality and Javascript callbacks
+
+The components that are "excluded" by the minimal build can be customised via the `build.properties` file.
+
+==== 4.2.1 Customising the Build Properties ====
+
+Being written
+
+==== 4.2.2 Building the OVA SWC ====
+
 To build OVA for AS3 use the following command from the OVA for AS3 `build` directory:
 
@@ -184 +198 @@
 
    * `help` - lists all available build commands
-   * `build` - does the default build (equivalent to `build-debug`)
+   * `build` - does the default build - building a debug, release and minimal OVA SWC libraries
+   * `deploy` - builds and deploys the `debug` version of the OVA SWC to the OVA plugin directories so that they can use the SWC in their own build processes
    * `build-debug` - builds a debuggable version of the OVA SWC
    * `build-release` - builds a version of the OVA SWC that excludes any debug output 
@@ -190 +205 @@
    * `build-deploy` - builds a debug version of the OVA SWC and deploys it across the installed OVA products (e.g. OVA for JW5, OVA for Flowplayer)
 
-==== 4.2.1 Customising the Build Properties ====
-
-Being written
-
 ==== 4.2.2 Deploying a Build OVA SWC Library ====
 
 Being written
 
-==== 4.2.3 Producing a Smaller OVA SWC ====
-
-Being written
+=== 4.3 Building OVA for JW5 ===
+
+Being written
+
+=== 4.4 Building OVA for Flowplayer ===
+
+Being written