japi-compliance-checker - Dalam talian di Cloud

JADUAL:

NAMA

japi-compliance-checker - Semak keserasian ke belakang bagi API perpustakaan Java

DESCRIPTION

NAMA:
Java API Compliance Checker (japi-compliance-checker) Semak keserasian ke belakang
API perpustakaan Java

HURAIAN:
Pemeriksa Pematuhan API Java (Java ACC) ialah alat untuk menyemak ke belakang
keserasian binari/sumber API perpustakaan Java. Alat menyemak kelas
pengisytiharan versi lama dan baharu serta menganalisis perubahan yang mungkin pecah
keserasian: mengalih keluar ahli kelas, menambah kaedah abstrak, dsb. Pecahan
keserasian binari boleh mengakibatkan ranap atau tingkah laku yang tidak betul sedia ada
pelanggan yang dibina dengan versi lama perpustakaan jika mereka menjalankan dengan yang baharu. Pecah
keserasian sumber boleh mengakibatkan ralat penyusunan semula dengan perpustakaan baharu
versi.

Java ACC bertujuan untuk pembangun perpustakaan dan penyelenggara sistem pengendalian yang
berminat untuk memastikan keserasian ke belakang (iaitu membenarkan pelanggan lama menjalankan atau
untuk disusun semula dengan versi baharu perpustakaan).

Alat ini adalah perisian percuma: anda boleh mengedarkannya semula dan/atau mengubah suainya di bawah
syarat GNU LGPL atau GNU GPL.

PENGGUNAAN:
pemeriksa pematuhan japi [pilihan]

CONTOH:
japi-compliance-checker OLD.jar NEW.jar

OR

penyemak pematuhan japi -lib NAMA -tua OLD.xml -baru NEW.xml OLD.xml dan NEW.xml adalah
Deskriptor XML:



1.0





/path1/to/JAR(s)/ /path2/to/JAR(s)/ ...



SYARIKAT PILIHAN:
-h|-bantuan

Cetak bantuan ini.

-v|-versi

Maklumat versi cetakan.

-pembuangan

Cetak versi alat (1.4.3) dan jangan lakukan apa-apa lagi.

UMUM PILIHAN:
-l|-lib|-perpustakaan NAMA

Nama perpustakaan (tanpa versi).

-d1|-lama|-o LALUAN

Deskriptor versi perpustakaan pertama (lama). Ia mungkin salah satu daripada yang berikut:

1. Java ARchive (*.jar) 2. XML-deskriptor (VERSION.xml fail):



1.0





/path1/to/JAR(s)/ /path2/to/JAR(s)/

...



...

3. Lambakan API dijana oleh -pembuangan pilihan 4. Direktori dengan Arkib Java 5. Koma
senarai berasingan Arkib Java 6. Senarai direktori dipisahkan koma dengan Java
Arkib

Jika anda menggunakan 1, 4-6 jenis deskriptor maka anda harus menentukan nombor versi
bersama -v1 and -v2 pilihan juga.

Jika anda menggunakan *.jar sebagai deskriptor maka alat itu akan cuba mendapatkan pelaksanaan
versi daripada fail MANIFEST.MF.

-d2|-baharu|-n LALUAN

Deskriptor versi perpustakaan ke-2 (baharu).

EXTRA PILIHAN:
-pelanggan|-apl PATH

Pilihan ini membolehkan untuk menentukan Arkib Java klien yang perlu disemak
mudah alih kepada versi perpustakaan baharu.

-perduaan

Tunjukkan masalah keserasian "Binari" sahaja. Hasilkan laporan kepada
"bin_compat_report.html".

-sumber

Tunjukkan masalah keserasian "Sumber" sahaja. Hasilkan laporan kepada
"src_compat_report.html".

-v1|-versi1 NUM

Tentukan versi API pertama di luar deskriptor. Pilihan ini diperlukan jika anda ada
memilih jenis deskriptor alternatif (lihat -d1 pilihan).

Dalam kes umum anda harus menentukannya dalam deskriptor XML:



VERSION



-v2|-versi2 NUM

Tentukan versi perpustakaan ke-2 di luar deskriptor.

-s|-ketat

Anggap semua amaran keserasian API sebagai masalah.

-simpan-dalaman

Jangan langkau menyemak pakej ini:

*impl* *dalaman* *contoh* *com.oracle* *com.sun* *COM.rsa* *sun* *sunw*

-langkau-dalaman CORAK

Jangan semak pakej dalaman yang dipadankan dengan corak.

-pembuangan|-dump-api LALUAN

Buang API perpustakaan ke fail format TXT yang digzip. Anda boleh memindahkannya ke mana-mana dan lulus
bukannya deskriptor. Ia juga boleh digunakan untuk menyahpepijat alat. serasi
versi buang: 1.0<=V<=1.0

-senarai-kelas PATH

Pilihan ini membolehkan untuk menentukan fail dengan senarai kelas yang perlu diperiksa,
kelas lain tidak akan disemak.

-senarai-anotasi PATH

Menentukan fail dengan senarai anotasi. Alat ini hanya akan menyemak kelas
dianotasi oleh anotasi daripada senarai ini. Kelas lain tidak akan disemak.

-langkau-tidak digunakan

Langkau analisis kaedah dan kelas yang tidak digunakan lagi.

-ponteng kelas PATH

Pilihan ini membolehkan untuk menentukan fail dengan senarai kelas yang tidak sepatutnya
diperiksa.

-langkau-pakej PATH

Pilihan ini membolehkan untuk menentukan fail dengan senarai pakej yang tidak sepatutnya
diperiksa.

-pendek PATH

Hasilkan laporan ringkas tanpa bahagian 'Kaedah Ditambah'.

-laluan-laporan PATH

Laluan ke laporan keserasian. Lalai:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

-laluan-laporan-bin PATH

Laluan ke laporan keserasian "Perduaan". Lalai:

compat_reports/LIB_NAME/V1_to_V2/bin_compat_report.html

-laluan-laporan-src PATH

Laluan ke laporan keserasian "Sumber". Lalai:

compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html

-cepat

Analisis cepat. Dilumpuhkan:

- analisis nama parameter kaedah - analisis nilai medan kelas - analisis
penggunaan kaedah abstrak tambahan - perbezaan kaedah dan kelas yang tidak digunakan lagi

-susun

Dayakan pengisihan data dalam pembuangan API.

-tunjuk-akses

Tunjukkan tahap akses kaedah bukan awam yang disenaraikan dalam laporan.

-sembunyikan templat

Sembunyikan parameter templat dalam laporan.

-sembunyikan-pakej

-yang minimum

Tidak buat apa-apa.

-pakej rancangan

Tunjukkan nama pakej dalam laporan.

-had-terjejas HAD

Bilangan maksimum kaedah yang terjejas disenaraikan di bawah perihalan yang diubah
taip laporan.

LAIN PILIHAN:
-test

Jalankan ujian dalaman. Buat dua versi perpustakaan sampel yang tidak serasi dan jalankan
alat untuk menyemaknya untuk keserasian. Pilihan ini membolehkan untuk menyemak sama ada alat
berfungsi dengan betul dalam persekitaran semasa.

-nyahpepijat

Mod nyahpepijat. Cetak maklumat nyahpepijat pada skrin. Simpan peringkat analisis pertengahan
dalam direktori nyahpepijat:

nyahpepijat/LIB_NAME/VER/

Pertimbangkan juga untuk menggunakan -pembuangan pilihan untuk menyahpepijat alat.

-tajuk NAMA

Tukar nama perpustakaan dalam tajuk laporan kepada NAME. Secara lalai akan dipaparkan a
nama yang ditentukan oleh -l pilihan.

-jdk-laluan PATH

Laluan ke pokok pemasangan JDK (cth /usr/lib/jvm/java-7-openjdk-amd64).

LAPORAN:
Laporan keserasian akan dijana kepada:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

EXIT KOD:
0 - Serasi. Alat telah berjalan tanpa sebarang ralat. bukan sifar - Tidak serasi atau
alat telah berjalan dengan ralat.

MORE MAKLUMAT:
http://ispras.linuxbase.org/index.php/Java_API_Compliance_Checker
https://github.com/lvc/japi-compliance-checker

Gunakan japi-compliance-checker dalam talian menggunakan perkhidmatan onworks.net