blob: 0ddb2f4d8d8d49b17133f589c27fc68ec8b14df5 [file] [log] [blame]
/*
* 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.
*/
Welcome to Apache Felix Dependency Manager
==========================================
Apache Felix Dependency Manager is a versatile java API, allowing to declaratively
register, acquire, and manage dynamic OSGi services.
Building and testing Apache Felix Dependency Manager
====================================================
** Compilation Using gradle:
- If necessary, configure your https proxy settings:
export GRADLE_OPTS="-Dhttps.proxyHost=www.somehost.org -Dhttps.proxyPort=8080"
- If you are building a released org.apache.felix.dependencymanager-r<n>-src.zip artifact, then
you also have to unfold the org.apache.felix.dependencymanager-r<n>-deps.zip on the same directory where you have unfolded the source archive.
(no need to do this if you have checked out from the felix-trunk).
- Install java7.
- Compile Dependendency Manager annotations bndtools plugin:
$ ./gradlew org.apache.felix.dependencymanager.annotation:jar
- Compile all other bundles:
$ ./gradlew jar
- run junit tests:
$ ./gradlew test
- run integration tests:
$ ./gradlew check
** Compilation Using Eclipse:
- Install latest Eclipse Mars, and configure two JREs for both java7 and java8:
* go to Windows -> Preferences -> Java -> Installed JREs
* Then add two JREs: one for java7, and the other for java8.
* Declare the java7 JRE as the default one.
Java8 is only used to build and run the org.apache.felix.dependencymanager.benchmark module, which is used to perform
DM performance tests within eclipse bndtools.
- Install BndTools 3.0.0
- Open BndTools perspective
- Import Dependency Manager into Eclipse, and compile everything
- if it's the first time you import the project into eclipse, it may happen that some modules that requires the
Dependency Manager Annotations bnd plugin don't compile: It's a know issue. To work around, restart eclipse and
rebuild every modules.
- Click on org.apache.felix.dependencymanager project and run it as "JUnit test".
- Click on org.apache.felix.dependencymanager.shell and run it as "JUnit test"
- Click on org.apache.felix.dependencymanager.itest and run it as "Bnd OSGi Test Launcer (Junit)".
- Click on org.apache.felix.dependencymanager.runtime.itest and run it as ""Bnd OSGi Test Launcer (Junit)".
Getting Started
===============
To start using Apache Felix Dependency Manager, please go to our website and read the
getting started guide for users:
http://felix.apache.org/documentation/subprojects/apache-felix-dependency-manager.html
Many examples are also available from the dependency manager samples module.
See ./org.apache.felix.dependencymanager.samples/README.samples
Many thanks for using Apache Felix Dependency Manager.
The Felix Team