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
|
Follow the instructions to setup the ABI Tracker for your library:
1) Please look at the README of the ABI Tracker and ABI Monitor tools:
https://github.com/lvc/abi-tracker
https://github.com/lvc/abi-monitor
2) You need to install basic packages to the system:
elfutils
libelf-devel
ctags
wdiff
wget
git
rfcdiff (https://tools.ietf.org/tools/rfcdiff/)
3) You need to install these tools to the system:
abi-tracker
abi-monitor
abi-dumper
abi-compliance-checker
pkgdiff
vtable-dumper
You can use the installer for that: https://github.com/lvc/installer/releases
Just extract the package of installer and execute:
sudo make install prefix=/usr target=abi-tracker
All packages will be downloaded from the github.com/lvc and installed to the "/usr" directory.
To uninstall:
sudo make uninstall prefix=/usr target=abi-tracker
4) Please install also necessary tools to build your library:
automake
cmake
gcc
g++
...
5) Create initial profile for your library (PROFILE.json):
{
"Name": "SHORT LIBRARY NAME",
"SourceUrl": "URL TO DOWNLOAD PACKAGES",
"Git": "GIT ADDRESS TO CLONE"
}
6) Download and build latest packages of your library:
abi-monitor -get PROFILE.json
abi-monitor -build --limit=10 PROFILE.json
7) Create analysis reports:
abi-tracker -build PROFILE.json
8) Rebuild some reports if needed:
abi-tracker -rebuild -target abireport -v X.Y.Z PROFILE.json
9) Cron job for daily monitoring and analysis:
abi-monitor -get -build-new PROFILE.json
abi-tracker -build PROFILE.json
10) The home page of the report will be generated to:
timeline/<LIBRARY NAME>/index.html
Enjoy!
|