forked from borisbrodski/sevenzipjbinding
-
Notifications
You must be signed in to change notification settings - Fork 3
/
README
245 lines (173 loc) · 9.5 KB
/
README
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
--- Welcome to 7-Zip-JBinding README file ---
7-Zip-JBinding is a free cross-platform java binding of 7-Zip free compress/decompress library
(http://www.7-zip.org/, http://p7zip.sourceforge.net/)
Content
-------
1. License Info
2. GNU LGPL information
3. License notes
4. Documentation
5. Version number guide lines
6. Compile
6.1 Compile on Linux
6.2 Compile on Windows
7. Developer notes
7.1 Applying new 7-Zip release
1. License Info
---------------
7-Zip-JBinding and 7-Zip/p7zip binaries are licensed under GNU LGPL.
For more information about 7-Zip source code licenses please see
7-Zip read me file. For more information about p7zip source code
please see p7zip read me file.
2. GNU LGPL information
-----------------------
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
3. License notes
----------------
You can support development of 7-Zip by registering.
7-Zip/p7zip/7-Zip-JBinding is free software distributed under the GNU LGPL.
If you need license with other conditions, write to
http://www.7-zip.org/support.html
6. Documentation
----------------
The documentation provided in multiple ways:
- ReleaseNotes.txt
Summary of the included features. Found in each distribution and online (http://sevenzipjbind.sourceforge.net/)
- Small introduction + collection of code snippets
Online: http://sevenzipjbind.sourceforge.net/first_steps.html
Also a copy of the archived web page is included in each distribution (website.zip)
- JavaDoc
Provided as a seperate archive within each distribution (javadoc.zip)
Also JavaDoc is included in both archived web page within the distribution (website.zip) and online
5. Version number guide lines
-----------------------------
The scheme for the 7-Zip-JBinding version numbers is:
<7-Zip/p7zip version> - <7-Zip-JBinding major version>.<7-Zip-JBinding minor version><release stage><impl. stage>
7-Zip/p7zip version - version of the underlying 7-Zip and p7zip libraries.
7-Zip-JBinding major version - major version of 7-Zip-JBinding base on the specified 7-Zip/p7zip version, beginning from 1
7-Zip-JBinding minor version - major version of 7-Zip-JBinding base on the specified 7-Zip/p7zip version, beginning from 0
release stage:
- 'alpha' - alpha release: substantial part of the functionality included, not stable. For testing purposes only.
- 'rc' / 'beta' - release candidate: all functionality included, not tested enough to be considered stable. Use with care.
- '' - release considered stable. For generally use.
impl stage: (implementation stage)
Optional. Information about implemented and not implemented features.
- '-extr-only' - compression features are not included.
Examples:
4.65-1.0alpha - Alpha release of 7-Zip-JBinding version 1.0 based on 7-Zip/p7zip version 4.65
4.66-1.01rc - Release candidate of 7-Zip-JBinding version 1.1 based on 7-Zip/p7zip version 4.66
4.66-1.01beta - Release candidate of 7-Zip-JBinding version 1.1 based on 7-Zip/p7zip version 4.66
4.66-2.3-extr-only - Stable release of 7-Zip-JBinding version 2.3 based on 7-Zip/p7zip version 4.66
without compression features.
4.66-2.3 - Stable release of 7-Zip-JBinding version 2.3 based on 7-Zip/p7zip version 4.66
6. Compile
----------
Please note, you will need a source code distribution to compile 7-Zip-JBinding.
Hint: for more examples how to compile 7-Zip-JBinding see "<git-root>/scripts" directory (https://github.com/borisbrodski/sevenzipjbinding/tree/master/scripts)
6.1 Compile on Linux
a) Download source package from http://sourceforge.net/projects/sevenzipjbind/files/
and extract it into some <srcdir> directory. Try to avoid directory names with spaces in your path.
Optionally you can checkout a master (current development version) from GIT repository
$ git clone git://sevenzipjbind.git.sourceforge.net/gitroot/sevenzipjbind/sevenzipjbind SevenZipJBinding
or
$ git clone https://github.com/borisbrodski/sevenzipjbinding.git SevenZipJBinding
$ cd SevenZipJBinding
$ git checkout Release-4.65-1.02rc-extr-only
b) You will need the CMake (2.6 or higher) to configure 7-Zip-JBinding for your system.
You can check the version of your CMake by typing:
$ cmake --version
If you don't have cmake installed or cmake version isn't sufficient you can download and install CMake from official
web site: http://www.cmake.org/
On Debian or Ubuntu Linux you can install cmake by typing
$ sudo apt-get install cmake
c) The next step is to run CMake. Both in-source and out-of-source methods are supported. Here is example of in-source build:
$ cmake .
Where <srcdir> is a directory, where you extracted or checked out the source code.
On some Linux distributions you will need to set JAVA_JDK cmake option to your Java JDK 1.5 or higher. You can use a GUI CMake
tool 'cmake-gui', edit 'CMakeCache.txt' file with your favorite text editor or just delete 'CMakeCache.txt' file
and restart CMake with a -DJAVA_JDK parameter:
$ cmake . -DJAVA_JDK=<path-to-jdk>
If everything goes right, you will get an overview of chosen tools and build options.
d) Now type to compile 7-Zip-JBinding
$ make
e) After make succeeds either run tests by typing
$ ctest
or
$ ctest -D Experimental
to submit test results to the dashboard (http://my.cdash.org/index.php?project=7-Zip-JBinding)
RUNTIME_JAVA_OPTS environment variable passes options to the test java process.
Run tests in Verbose-Mode:
$ RUNTIME_JAVA_OPTS="-DTEST_TRACE=1" ctest
Run tests in specified profile
$ RUNTIME_JAVA_OPTS="-DTEST_PROFILE=MINIMAL" ctest
For example, run tests on armel 256MB RAM architecture:
$ RUNTIME_JAVA_OPTS="-DTEST_ON_LOW_MEMORY=1" ctest
To directly see the standard output of the running tests, use
$ RUNTIME_JAVA_OPTS=-DTEST_TRACE=true ctest -VV
To Run specified test first list all available tests with
$ ctest -N
then specify a range of tests to execute. The following will execute tests #2, #3, #4 and #5
$ ctest -I 2,5
f) Build a binary package by typing
$ make package
g) Running tests on a machine with low memory (like 256M on ARM armel):
- Add "-DJAVA_PARAMS=-DTEST_ON_LOW_MEMORY=1" to the cmake parameters
to skip most memory intensive tests (executed later by the ctest tool see (e) ).
6.2 Compile on Windows
Both MinGW and Cygwin environments can be used to compile 7-Zip-JBinding. Using MinGW to compile 7-Zip-JBinding
is recommended and is much easier. The steps are:
a) Download and install MinGW from the official web site: http://www.mingw.org/
b) Download and install CMake from the official web site: http://www.cmake.org/
c) Download and extract 7-Zip-Binding source package from http://sourceforge.net/projects/sevenzipjbind/files/
d) Open cmd console, go into the directory with extracted 7-Zip-Binding source and type
D:\...> cmake -G"MinGW Makefiles" .
e) Type
D:\...> mingw32-make.exe
f) Type 'ctest' to run tests or 'mingw32-make.exe package' to build a binary package
6.3 Compile with DockCross
DockCross - cross compiling toolchains in Docker images: https://github.com/dockcross/dockcross
DockCross allows easy cross-platform compilation for different Linux/Windows architectures, line Linux ARMv5 (armel), ARMv5 (armhf), ...
To compile 7-Zip-JBinding on Linux with DockCross:
a) Install DockCross according to installation instructions on the home page (https://github.com/dockcross/dockcross)
b) Check out or copy 7-Zip-JBinding source code to your build directory
$ git clone https://github.com/borisbrodski/sevenzipjbinding.git SevenZipJBinding
c) Copy JDK to your build directory to make it visible to the container.
$ cp -r <my-JDKs>/jdk1.5.0_22 ./jdk1.5.0_22
(Mostly for jni.h and stuff. JDK must not match the target platform.)
d) Define build command sequence, like this one:
$ CMD='
mkdir build ;
cd build ;
cmake ../SevenZipJBinding -DJAVA_SYSTEM=arm -DJAVA_ARCH=v6 -DCMAKE_BUILD_TYPE=Release -DJAVA_JDK=../jdk1.5.0_22/
make
make package
'
c) Run build:
$ dockcross-linux-armv6 bash -c "$CMD"
d) Unfortunately it's not possible to run the tests in the same way, unless your
host platform is compatible with the target platform.
If you have any troubles with 7-Zip-JBinding please, ask for help. Use forum or issue tracker on sourceforge:
Forum: http://sourceforge.net/forum/?group_id=210915
Tracker: http://sourceforge.net/tracker/?group_id=210915
7 Developer notes
7.1 Binding new 7-Zip release
TODO describe this
- In StringConvert.cpp
- Remove SystemStringToOemString() method
- In StringConvert.h
- Remove SystemStringToOemString() method definition
- Verify, that the implementations in
- PlatformMinGW/MyWindows.cpp
- PlatformMinGW/MyUser32.cpp
still match corresponding implementation in the p7zip
Have fun!