summaryrefslogtreecommitdiff
path: root/cli_ure/qa
diff options
context:
space:
mode:
authorKurt Zenker <kz@openoffice.org>2006-02-03 16:13:50 +0000
committerKurt Zenker <kz@openoffice.org>2006-02-03 16:13:50 +0000
commit27a59b1ffca8a993cb1be7bc17a0a18f71c5ca85 (patch)
treecac74929b0f0a8493c28f3cc4a299cc8fe4bcf8d /cli_ure/qa
parent53a447744a09ea6d6131874c33b85c469800f980 (diff)
INTEGRATION: CWS jl30 (1.1.2); FILE ADDED
2006/01/27 15:47:33 jl 1.1.2.2: #61051# new versions offor assemblies and qa/versions test 2006/01/27 15:21:36 jl 1.1.2.1: #61051# new versions offor assemblies and qa/versions test
Diffstat (limited to 'cli_ure/qa')
-rw-r--r--cli_ure/qa/versioning/readme.txt37
1 files changed, 37 insertions, 0 deletions
diff --git a/cli_ure/qa/versioning/readme.txt b/cli_ure/qa/versioning/readme.txt
new file mode 100644
index 000000000000..0fbe3502fd83
--- /dev/null
+++ b/cli_ure/qa/versioning/readme.txt
@@ -0,0 +1,37 @@
+WINDOWS ONLY, no other platforms
+
+
+This test checks if the cli assemblies and their policy files are installed in the GAC and if the policy files are correct. The office must be installed with complete system integration. That is, one does not use setup /a for starting the installation.
+
+In the sub directory version_libs are libraries which are all using (referencing)
+cli_cppuhelper
+cli_basetypes
+cli_ure
+cli_types.
+
+They are named version_2_0_1 etc, where the name in indicate the version of the office for which they were initially build.
+If there are only the assemblies for example OOo2.0.2 installed and a client was build with the assemblies from OOo2 then the policy assemblies must make the correct redirection.
+
+When calling dmake in qa/versioning then an executable runtest.exe and version.dll are build. When runtest runs then it loads all dlls from the directory and tries to run a particular test code which is only available in the version_xxx.dll s. The code in the version_xxx.dlls uses the default bootstrap mechanism to find the office installation and start the office. When running runtest in a build environment then it may use the wrong libraries for bootstrapping in which case the test fails. Then one has to set PATH which must point to the program directory of the office installation. For example:
+set PATH=d:\office\program
+
+runtest stops when a test failed to run. It writes error information on the console which shows which version_xxx.dll failed to run and if this was due to a referenced assembly that could not be loaded. This would be the case if such an assembly or the policy assembly is not properly installed or the redirection in the policy assembly is wrong.
+
+The version_current.dll contains the test. It is build with references to the assemblies in bin directory of this project. That is, it references always the current versions of the assemblies, with "current" meaning the current build environment. version_current.dll is also executed when runtest is started.
+
+The test framework is started with
+dmake run office=d:\office
+
+The parameter office must be a system path to the office installation directory. The java code calls runtest and also sets PATH so that the test works in the build environment. If the test says that it failed, then one should run runtest directly because it puts out more information.
+
+
+
+Creating a new version_xxx.dll
+==============================
+When a version of our assemblies changes then one should provide a new version dll which test exactly the assemblies with the changed version. This is easily done:
+1. set the build environment in which the new versions are effectiv.
+2 call: dmake name=version_xxx.dll
+3. copy the new version dll from the output tree into qa/versioning/version_libs
+4. commit the new version.dll using the -kb switch (only when creating the new file : cvs new -kb version_2_0_2.dll)
+Notice: Avoid naming the dll version.dll. This caused an exception but I could not make out why.
+