| #************************************************************** | |
| # | |
| # Licensed to the Apache Software Foundation (ASF) under one | |
| # or more contributor license agreements. See the NOTICE file | |
| # distributed with this work for additional information | |
| # regarding copyright ownership. The ASF licenses this file | |
| # to you under the Apache License, Version 2.0 (the | |
| # "License"); you may not use this file except in compliance | |
| # with the License. You may obtain a copy of the License at | |
| # | |
| # http://www.apache.org/licenses/LICENSE-2.0 | |
| # | |
| # Unless required by applicable law or agreed to in writing, | |
| # software distributed under the License is distributed on an | |
| # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | |
| # KIND, either express or implied. See the License for the | |
| # specific language governing permissions and limitations | |
| # under the License. | |
| # | |
| #************************************************************** | |
| This directory contains test files for the UNO Runtime Environment (URE) as well | |
| as the Makefile and Makefile.pln makefiles. To execute the makefiles, you need | |
| GNU make 3.80 or later. | |
| Makefile | |
| -------- | |
| Before you execute Makefile, you need to configure the Software Development Kit | |
| (SDK) environment to work with a URE installation, a C++ compiler, and a JDK. | |
| For more information, read the .../docs/install.html file in the SDK | |
| installation. | |
| Makefile.pln | |
| ------------ | |
| You can only run Makefile.pln on Linux x86. You do not need to configure your | |
| SDK environment to use this makefile, however, you do need to set the following | |
| environment variables: | |
| - SDK_HOME | |
| Points to the base directory of an OpenOffice.org SDK so that you can access UNO | |
| programming tools and files that are not part of the URE. For example, idlc, | |
| cppumaker, javamaker, UNOIDL files, and C++ headers. | |
| - PATH | |
| Points to a GCC installation (including g++) as well as a JDK installation that | |
| contains the java, javac, and jar executables. For the minimum version | |
| requirements, see the SDK Installation Guide ($SDK_HOME/docs/install.html). | |
| - URE_HOME (optional) | |
| Overwrites the default URE location, that is, /opt/openoffice.org/ure. | |
| Tests | |
| ----- | |
| Makefile and Makefile.pln can execute the following tests: | |
| - test-cpptest | |
| Builds a C++ UNO component, cppmain.uno, and runs the component with the uno | |
| executable. The component first attempts to instantiate all the UNO services | |
| and singletons that are part of the URE installation. The component then tries | |
| to instantiate and to call another C++ UNO component (ccptest.uno) as well as a | |
| Java UNO component (javatest.uno). The test completes when these components | |
| throw a special exception that is caught by cppmain.uno. | |
| - test-javatest | |
| Builds a Java UNO component, javamain.uno, and runs the component with the uno | |
| executable. The component tries to instantiate and to call a C++ UNO component | |
| (cpptest.uno) as well as a Java UNO component (javatest.uno). The test | |
| completes when these components throw a special exception that is caught by | |
| javamain.uno. | |
| - test-javanative | |
| Builds a Java UNO application, javanative.jar, and runs the application with the | |
| java executable. The application bootstraps a native UNO environment, and then | |
| tries to instantiate and to call a C++ UNO component (cpptest.uno) as well as a | |
| Java UNO component( javatest.uno). The test completes when these components | |
| throw a special exception that is caught by javanative.jar. | |
| - test-clientserver | |
| Builds a server C++ UNO component, cppserver.uno, and a Java UNO application, | |
| javaclient.uno. The uno executable runs the cppserver.uno component which | |
| listens on a pipe connection. The java executable runs the javaclient.uno | |
| component which connects to the server after a five second pause so that the | |
| server has enough time to start. | |
| - test-regview (Makefile.pln only) | |
| Checks that the regview executable of the URE installation works reliably. | |
| NOTE: The files that are generated when Makefile and Makefile.pln execute are | |
| saved to different local directories. Makefile outputs the generated files to | |
| ./out.sdk whereas Makefile.pln outputs the files to ./out.pln. |