Skip to content

Commit 9798413

Browse files
committed
80c69a4 Release note for v1.4.1
9db77d4 update log4cplus download link 4612489 use min-install-script for java jni build
1 parent 9da2019 commit 9798413

File tree

3 files changed

+31
-29
lines changed

3 files changed

+31
-29
lines changed

README.md

Lines changed: 29 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -36,19 +36,19 @@ Please install the following additional build tools before proceeding with `./in
3636
After you've downloaded the code from GitHub, you can build it on Mac OS or Ubuntu using `./install-script` (which is inside the `kinesis-video-native-build` directory).
3737

3838
**Important** Change *current working directory* to the `kinesis-video-native-build` directory first. Then run the `./install-script` from that directory.
39-
39+
4040
This will produce the core library, the JNI library, unit tests executable and the sample GStreamer application. The script will download and build the dependent open source components in the 'downloads' directory (within `kinesis-video-native-build` directory)and link against it.
41-
41+
4242
#### Build the binaries using system versions
43-
The bulk of the install script is building the open source dependencies. The project is based on **CMake**. So the open source components building can be skipped if the system versions can be used for linking.
43+
The bulk of the install script is building the open source dependencies. The project is based on **CMake**. So the open source components building can be skipped if the system versions can be used for linking.
4444

45-
Running
45+
Running
4646

4747
```
48-
$ cmake .
48+
$ cmake .
4949
$ make
5050
```
51-
from the `kinesis-video-native-build` directory will build and link the SDK.
51+
from the `kinesis-video-native-build` directory will build and link the SDK.
5252
The `./min-install-script` inside the `kinesis-video-native-build` captures these steps for installing the Kinesis Video Streams Producer SDK with the system versions for linking.
5353

5454
#### Build the binaries using the dependent libraries from source
@@ -98,14 +98,14 @@ Many platforms come with a cert file with a lot of the well-known public certs i
9898
## Install Steps for Ubuntu 17.x using apt-get
9999
The following are the steps to install the build-time prerequisites for Ubuntu 17.x
100100

101-
Install **git**:
101+
Install **git**:
102102

103-
```
103+
```
104104
$ sudo apt-get install git
105105
$ git --version
106106
git version 2.14.1
107107
```
108-
Install **cmake**:
108+
Install **cmake**:
109109
```
110110
$ sudo apt-get install cmake
111111
$ cmake --version
@@ -125,7 +125,7 @@ Copyright (C) 2014 Free Software Foundation, Inc.
125125
This is free software; see the source for copying conditions. There is NO
126126
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
127127
```
128-
Install **automake**:
128+
Install **automake**:
129129
```
130130
$ sudo apt-get install automake
131131
$ automake --version
@@ -138,7 +138,7 @@ There is NO WARRANTY, to the extent permitted by law.
138138
Written by Tom Tromey <[email protected]>
139139
and Alexandre Duret-Lutz <[email protected]>.
140140
```
141-
Install **g++**:
141+
Install **g++**:
142142
```
143143
$ sudo apt-get install g++
144144
$ g++ --version
@@ -147,7 +147,7 @@ Copyright (C) 2017 Free Software Foundation, Inc.
147147
This is free software; see the source for copying conditions. There is NO
148148
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
149149
```
150-
Install **curl**:
150+
Install **curl**:
151151
```
152152
$ sudo apt-get install curl
153153
$ curl --version
@@ -156,13 +156,13 @@ Release-Date: 2017-08-14
156156
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtmp rtsp smb smbs smtp smtps telnet tftp
157157
Features: AsynchDNS IDN IPv6 Largefile GSS-API Kerberos SPNEGO NTLM NTLM_WB SSL libz TLS-SRP UnixSockets HTTPS-proxy PSL
158158
```
159-
Install **pkg-config**:
159+
Install **pkg-config**:
160160
```
161161
$ sudo apt-get install pkg-config
162162
$ pkg-config --version
163163
0.29.1
164164
```
165-
Install **flex**:
165+
Install **flex**:
166166
```
167167
$ sudo apt-get install flex
168168
$ flex --version
@@ -179,19 +179,19 @@ Copyright (C) 2015 Free Software Foundation, Inc.
179179
This is free software; see the source for copying conditions. There is NO
180180
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
181181
```
182-
Install **Open JDK**:
182+
Install **Open JDK**:
183183
```
184184
$ sudo apt-get install openjdk-8-jdk
185185
$ java -showversion
186186
openjdk version "1.8.0_151"
187187
OpenJDK Runtime Environment (build 1.8.0_151-8u151-b12-0ubuntu0.17.10.2-b12)
188188
OpenJDK 64-Bit Server VM (build 25.151-b12, mixed mode)
189189
```
190-
Set **JAVA_HOME** environment variable:
190+
Set **JAVA_HOME** environment variable:
191191
```
192192
$ export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64/
193193
```
194-
Run the build script: (within `kinesis-video-native-build` folder)
194+
Run the build script: (within `kinesis-video-native-build` folder)
195195
```
196196
./install-script
197197
```
@@ -217,7 +217,7 @@ The GStreamer demo app will be built in `kinesis_video_gstreamer_sample_app` in
217217
Usage: AWS_ACCESS_KEY_ID=<SAMPLEKEY> AWS_SECRET_ACCESS_KEY=<SAMPLESECRET> ./kinesis_video_gstreamer_sample_app -w <width> -h <height> -f <framerate> -b <bitrateInKBPS> <my_stream_name>
218218
```
219219
* **A.** If resolution is provided then the sample will try to check if the camera supports that resolution. If it does detect that the camera can supprt the resolution supplied in command line, then streaming starts; else, it will fail with an error msg `Resolution not supported`
220-
220+
221221
* **B.** If no resolution is specified, the demo will try to use these three resolutions **1920x1080, 1280x720 and 640x480** in that order (highest resolution first) and will **start streaming** once the camera supported resolution is detected.
222222

223223
#### GStreamer RTSP demo application
@@ -244,7 +244,7 @@ Define `HEAP_DEBUG` and `LOG_STREAMING` C-defines by uncommenting the appropriat
244244

245245
#### Additional Examples
246246

247-
For additional examples on using Kinesis Video Streams Java SDK and Kinesis Video Streams Parsing Library refer:
247+
For additional examples on using Kinesis Video Streams Java SDK and Kinesis Video Streams Parsing Library refer:
248248

249249
##### [Kinesis Video Streams Producer Java SDK](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-java/blob/master/README.md)
250250
##### [Kinesis Video Streams Parser Library](https://github.com/aws/amazon-kinesis-video-streams-parser-library/blob/master/README.md)
@@ -257,15 +257,15 @@ For additional examples on using Kinesis Video Streams Java SDK and Kinesis Vid
257257
### Troubleshooting
258258

259259
##### Ubuntu builds link issues
260-
Ubuntu bulds link against the system versions of the open source component libraries or missing .so files (./start in the kinesis-video-native-build directory shows linkage against system versions of the open source libraries).We are working on providing fix but the immediate steps to remedy is to run
260+
Ubuntu bulds link against the system versions of the open source component libraries or missing .so files (./start in the kinesis-video-native-build directory shows linkage against system versions of the open source libraries).We are working on providing fix but the immediate steps to remedy is to run
261261

262262
```
263263
rm -rf ./kinesis-video-native-build/CMakeCache.txt ./kinesis-video-native-build/CMakeFiles
264-
```
265-
and run
264+
```
265+
and run
266266
```
267267
./install-script
268-
```
268+
```
269269
to rebuild and re-link the project only.
270270

271271
##### Library not found error when running the demo application
@@ -291,7 +291,7 @@ $ls /dev/video*
291291
{not found}
292292
```
293293
```
294-
$vcgencmd get_camera
294+
$vcgencmd get_camera
295295
```
296296
Example output:
297297
```
@@ -305,7 +305,7 @@ if the driver does not detect the camera then
305305
$sudo modprobe bcm2835-v4l2
306306
```
307307
```
308-
$ls /dev/video*
308+
$ls /dev/video*
309309
{lists the device}
310310
```
311311

@@ -320,7 +320,7 @@ $ sudo reboot
320320
* Raspberry PI GStreamer assertion on gst_value_set_fraction_range_full: assertion 'gst_util_fraction_compare (numerator_start, denominator_start, numerator_end, denominator_end) < 0' failed. The uv4l service running in the background. Kill the service and restart the sample app.
321321

322322

323-
##### Raspberry PI seg fauls after some time running on `libx264.so`.
323+
##### Raspberry PI seg fauls after some time running on `libx264.so`.
324324
Rebuilding the `libx264.so` library and **re-linking the demo application** fixes the issue.
325325

326326
##### Curl SSL issue - "unable to get local issuer certificate"
@@ -341,13 +341,15 @@ make install
341341

342342

343343
## Release Notes
344+
#### Release 1.4.1 (8th May 2018)
345+
* Update log4cplus download link in install-script
344346
#### Release 1.4.0 (25th April 2018)
345347
* Fix for crash caused by latest Mac tool chain issue
346348
* Fix for callbacks returning incorrect custom data in gstreamer sample app
347349
* Support for custom logger
348350
* Fix for multiple callbacks when triggering connection staleness
349351
#### Release 1.3.1 (5th April 2018)
350-
* Fixed video source negotiation error caused by camera with fractional fps
352+
* Fixed video source negotiation error caused by camera with fractional fps
351353
* Docker suport for RTSP streaming
352354
#### Release 1.3.0 (15th March 2018)
353355
* Fixed producer intermittent termination issue for some edge cases involving re-streaming on error.

kinesis-video-native-build/install-script

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ if [ ! -f $DOWNLOADS/local/lib/liblog4cplus.dylib ]; then
125125
echo "log4cplus lib not found. Installing"
126126
if [ ! -f $DOWNLOADS/log4cplus-1.2.0.tar.xz ]; then
127127
cd $DOWNLOADS
128-
curl -L "https://versaweb.dl.sourceforge.net/project/log4cplus/log4cplus-stable/1.2.0/log4cplus-1.2.0.tar.xz" -o "log4cplus-1.2.0.tar.xz"
128+
curl -L "https://sourceforge.net/projects/log4cplus/files/log4cplus-stable/1.2.0/log4cplus-1.2.0.tar.xz" -o "log4cplus-1.2.0.tar.xz"
129129
fi
130130
cd $DOWNLOADS
131131
tar -xvf log4cplus-1.2.0.tar.xz

kinesis-video-native-build/min-install-script

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ if [ ! -f $DOWNLOADS/local/lib/liblog4cplus.dylib ]; then
3838
echo "log4cplus lib not found. Installing"
3939
if [ ! -f $DOWNLOADS/log4cplus-1.2.0.tar.xz ]; then
4040
cd $DOWNLOADS
41-
curl -L "https://versaweb.dl.sourceforge.net/project/log4cplus/log4cplus-stable/1.2.0/log4cplus-1.2.0.tar.xz" -o "log4cplus-1.2.0.tar.xz"
41+
curl -L "https://sourceforge.net/projects/log4cplus/files/log4cplus-stable/1.2.0/log4cplus-1.2.0.tar.xz" -o "log4cplus-1.2.0.tar.xz"
4242
fi
4343
cd $DOWNLOADS
4444
tar -xvf log4cplus-1.2.0.tar.xz

0 commit comments

Comments
 (0)