aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 9c987fb8c5dd09b35398288872be3b0144872224 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
OpenEmbedded/Yocto Project layer for Java support
=================================================

This layer provides support for Java for use with OpenEmbedded and/or
Yocto Project build systems.

This layer depends on:

URI: git://git.openembedded.org/openembedded-core
branch: master
revision: HEAD

URI: git://git.openembedded.org/meta-openembedded
sub-layer: meta-oe
branch: master
revision: HEAD

Furthermoe for oeqa runtime testing this layer depends on:

URI: git://git.yoctoproject.org/poky
sub-layer: meta-poky
branch: master
revision: HEAD

For use with a specific Yocto Project release please refer to the corresponding
git branches.

Guides on how to contribute to meta-java are described in CONTRIBUTING.md.

Testing
-------

The meta-java layer may be tested using oeqa's runtime image tests. The easiest
way is to add the following configuration to your local.conf:

SANITY_TESTED_DISTROS = ""
INHERIT += "testimage"
TESTIMAGE_AUTO = "1"

Then you should be able to use the open{jre,jdk}-{7,8}-test-image recipes.
Furthermore you could also include the tests provided in lib/oeqa/runtime/cases
into your test image. More information on image testing is available at:

	https://wiki.yoctoproject.org/wiki/Image_tests

Known Limitations/Bugs
----------------------

 + OpenJDK-7 doesn't support musl based images
 + Both, OpenJDK-7 and 8 doesn't support mips and mips64 machines
 + Further limitations are shown in the OpenJDK version/libc/target architecture
   support matrix below:
   +--------+-----------------+-----------------+-----------------+
   |        | OpenJDK-7/glibc | OpenJDK-8/glibc | OpenJDK-8/musl  |
   +--------+-----------------+-----------------+-----------------+
   | arm    |       O K       |    int. mode    |    int. mode    |
   +--------+-----------------+-----------------+-----------------+
   | armv7  |       O K       |       O K       |       O K       |
   +--------+-----------------+-----------------+-----------------+
   | arm64  |    int. mode    |       O K       |       O K       |
   +--------+-----------------+-----------------+-----------------+
   | x86    |    int. mode    |       O K       |  build failure  |
   +--------+-----------------+-----------------+-----------------+
   | x86-64 |    int. mode    |       O K       |       O K       |
   +--------+-----------------+-----------------+-----------------+
   | ppc    |    int. mode    |  build failure  |  build failure  |
   +--------+-----------------+-----------------+-----------------+

If you encounter any other problems or bugs please report them to our mailing
list at yocto-patches@lists.yoctoproject.org.

Usage instructions
------------------

You should define at least the following variables in a distro include file or local.conf

# Possible provider: cacao-initial-native and jamvm-initial-native
PREFERRED_PROVIDER_virtual/java-initial-native = "cacao-initial-native"

# Possible provider: cacao-native and jamvm-native
PREFERRED_PROVIDER_virtual/java-native = "jamvm-native"

# Optional since there is only one provider for now
PREFERRED_PROVIDER_virtual/javac-native = "ecj-bootstrap-native"

Simply rely on openjdk-7-jre, openjdk-7, openjdk-8 or openjre-8.

For conf/bblayers.conf you have to add

BBLAYERS ?= " \
   ...
  path_to_source/meta-openembedded/meta-oe \
  path_to_source/sources/meta-java \
  "

Build host dependencies
-----------------------
 - gcc >= v6
 - libstdc++ static