jaucpp/README.md


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
100
101
102
103
104
105


    Contents⊕
  
  
  Jau C++ -
  C++ Support Library inclusive Java JNI Binding
  Git Repository
  Goals
  API Documentation
  Examples
  Supported Platforms
  Building Binaries
  Changes
  

Jau C++ -
C++ Support Library inclusive Java JNI Binding
Git Repository
This project's canonical repositories is hosted on Gothel Software.
Goals
This project aims to provide general C++ collections, algorithms and
utilizies inclusive utilizities for a Java JNI binding.
This project was extracted from Direct-BT to enable
general use and enforce better encapsulation.
API Documentation
Up to date API documentation can be found:

C++
API Doc.

Examples
See Direct-BT C++
API Doc.
Supported Platforms
C++17 and better.
Building Binaries
It is advised to include this library into your main project, e.g. as
a git-submodule.
Then add jaucpp/include/ to your include-path and also add
the source files under jaucpp/src/ into your build recipe.
This library's build recipe are functional though, but currently only
intended to support unit testing and to produce a Doxygen API doc.
The project requires CMake 3.1+ for building and a Java JDK >=
11.
Installing build dependencies on Debian (10 or 11):
apt install git
apt install build-essential g++ gcc libc-dev libpthread-stubs0-dev 
apt install libunwind8 libunwind-dev
apt install openjdk-11-jdk openjdk-11-jre
apt install cmake cmake-extras extra-cmake-modules
apt install doxygen graphviz
For a generic build use:
CPU_COUNT=`getconf _NPROCESSORS_ONLN`
git clone https://jausoft.com/cgit/jaucpp.git
cd jaucpp
mkdir build
cd build
cmake -DBUILDJAVA=ON -DBUILDEXAMPLES=ON -DBUILD_TESTING=ON ..
make -j $CPU_COUNT install test doc
The install target of the last command will create the include/ and
lib/ directories with a copy of the headers and library objects
respectively in your build location. Note that doing an out-of-source
build may cause issues when rebuilding later on.
Our cmake configure has a number of options, cmake-gui or
ccmake can show you all the options. The interesting ones are
detailed below:
Changing install path from /usr/local to /usr
-DCMAKE_INSTALL_PREFIX=/usr
Building debug build:
-DCMAKE_BUILD_TYPE=DEBUG
Using clang instead of gcc:
-DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang++
Cross-compiling on a different system:
-DCMAKE_CXX_FLAGS:STRING=-m32 -march=i586
-DCMAKE_C_FLAGS:STRING=-m32 -march=i586
To build Java bindings:
-DBUILDJAVA=ON
To build documentation run:
make doc
Changes
1.0.0

Extraction from Direct-BT