japi-compliance-checker - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

japi-compliance-checker - ກວດເບິ່ງຄວາມເຂົ້າກັນໄດ້ໃນດ້ານຫຼັງຂອງ API ຫ້ອງສະໝຸດ Java

ລາຍລະອຽດ

ຊື່:
Java API Compliance Checker (japi-compliance-checker) ກວດເບິ່ງຄວາມເຂົ້າກັນໄດ້ກັບຫຼັງ
ຂອງ Java library API

DESCRIPTION:
Java API Compliance Checker (Java ACC) ເປັນເຄື່ອງມືໃນການກວດສອບດ້ານຫຼັງ
ຄວາມເຂົ້າກັນໄດ້ຂອງຖານສອງ/ແຫຼ່ງຂອງ API ຫ້ອງສະໝຸດ Java. ເຄື່ອງມືກວດສອບຫ້ອງຮຽນ
ການປະກາດສະບັບເກົ່າແລະໃຫມ່ແລະການວິເຄາະການປ່ຽນແປງທີ່ອາດຈະແຕກແຍກ
ຄວາມເຂົ້າກັນໄດ້: ເອົາສະມາຊິກຫ້ອງຮຽນອອກ, ເພີ່ມວິທີການທີ່ບໍ່ມີຕົວຕົນ, ແລະອື່ນໆ
ຄວາມເຂົ້າກັນໄດ້ຂອງຄູ່ອາດຈະສົ່ງຜົນໃຫ້ເກີດການຂັດຂ້ອງ ຫຼືພຶດຕິກຳທີ່ບໍ່ຖືກຕ້ອງຂອງທີ່ມີຢູ່ແລ້ວ
ລູກຄ້າທີ່ສ້າງຂຶ້ນດ້ວຍຫ້ອງສະໝຸດສະບັບເກົ່າ ຖ້າພວກເຂົາແລ່ນດ້ວຍອັນໃໝ່. ການແຕກແຍກ
ຄວາມເຂົ້າກັນໄດ້ຂອງແຫຼ່ງອາດຈະເຮັດໃຫ້ເກີດຄວາມຜິດພາດໃນການລວບລວມຂໍ້ມູນກັບຫ້ອງສະຫມຸດໃຫມ່
ສະບັບ.

Java ACC ມີຈຸດປະສົງສໍາລັບຜູ້ພັດທະນາຫ້ອງສະຫມຸດແລະຜູ້ຮັກສາລະບົບປະຕິບັດງານຜູ້ທີ່
ມີ​ຄວາມ​ສົນ​ໃຈ​ໃນ​ການ​ຮັບ​ປະ​ກັນ​ຄວາມ​ເຂົ້າ​ກັນ​ໄດ້​ກັບ​ຄືນ​ໄປ​ບ່ອນ (ເຊັ່ນ​: ອະ​ນຸ​ຍາດ​ໃຫ້​ລູກ​ຄ້າ​ເກົ່າ​ທີ່​ຈະ​ດໍາ​ເນີນ​ການ​ຫຼື​
ຈະຖືກລວບລວມຄືນໃຫມ່ດ້ວຍຫ້ອງສະຫມຸດສະບັບໃຫມ່).

ເຄື່ອງ​ມື​ນີ້​ແມ່ນ​ຊອບ​ແວ​ຟຣີ​: ທ່ານ​ສາ​ມາດ​ແຈກ​ຢາຍ​ມັນ​ແລະ / ຫຼື​ປັບ​ປຸງ​ແກ້​ໄຂ​ພາຍ​ໃຕ້​ການ​
ເງື່ອນໄຂຂອງ GNU LGPL ຫຼື GNU GPL.

ການໃຊ້:
japi-compliance-checker [ຕົວເລືອກ]

ຕົວຢ່າງ:
japi-compliance-checker OLD.jar NEW.jar

OR

japi-compliance-checker - lib NAME -ເກົ່າ OLD.xml -ໃຫມ່ NEW.xml OLD.xml ແລະ NEW.xml ແມ່ນ
ຕົວອະທິບາຍ XML:



1.0





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



ຂໍ້ມູນ ທາງເລືອກ:
-h|-ຊ່ວຍ

ພິມການຊ່ວຍເຫຼືອນີ້.

-v|-ສະບັບ

ພິມຂໍ້ມູນສະບັບ.

- dumpversion

ພິມເວີຊັນເຄື່ອງມື (1.4.3) ແລະຢ່າເຮັດຫຍັງອີກ.

ທົ່ວໄປ ທາງເລືອກ:
-l|-lib|-library NAME

ຊື່ຫໍສະໝຸດ (ບໍ່ມີສະບັບ).

-d1|-old|-o ເສັ້ນທາງ

ຄຳອະທິບາຍຂອງຫ້ອງສະໝຸດສະບັບທີ 1 (ເກົ່າ). ມັນອາດຈະເປັນຫນຶ່ງໃນຕໍ່ໄປນີ້:

1. Java ARchive (*.jar) 2. XML-descriptor (ໄຟລ໌ VERSION.xml):



1.0





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

...



...

3. API dump ສ້າງຂຶ້ນໂດຍ - ຖິ້ມ ທາງເລືອກ 4. Directory ກັບ Java ARchives 5. ເຄື່ອງໝາຍຈຸດ
ບັນຊີລາຍຊື່ທີ່ແຍກອອກຂອງ Java ARchives 6. ລາຍຊື່ໄດເລກະທໍລີທີ່ແຍກດ້ວຍເຄື່ອງໝາຍຈຸດດ້ວຍ Java
ເອກະສານ

ຖ້າ​ຫາກ​ວ່າ​ທ່ານ​ກໍາ​ລັງ​ໃຊ້ 1, 4-6 descriptor ປະ​ເພດ​ຫຼັງ​ຈາກ​ນັ້ນ​ທ່ານ​ຄວນ​ຈະ​ລະ​ບຸ​ຕົວ​ເລກ​ສະ​ບັບ​
ກັບ -v1 ແລະ -v2 ທາງເລືອກເຊັ່ນກັນ.

ຖ້າທ່ານກໍາລັງໃຊ້ *.jar ເປັນຕົວອະທິບາຍ, ເຄື່ອງມືຈະພະຍາຍາມປະຕິບັດ
ເວີຊັນຈາກໄຟລ໌ MANIFEST.MF.

-d2|-new|-n ເສັ້ນທາງ

ຄຳອະທິບາຍຂອງຫ້ອງສະໝຸດສະບັບທີ 2 (ໃໝ່).

ພິເສດ ທາງເລືອກ:
-ລູກ​ຄ້າ|-app PATH

ຕົວເລືອກນີ້ອະນຸຍາດໃຫ້ລະບຸລູກຄ້າ Java ARchive ທີ່ຄວນຈະຖືກກວດສອບ
ການ​ເຄື່ອນ​ໄຫວ​ກັບ​ສະ​ບັບ​ຫ້ອງ​ສະ​ຫມຸດ​ໃຫມ່​.

- ຄູ່

ສະແດງບັນຫາຄວາມເຂົ້າກັນໄດ້ "Binary" ເທົ່ານັ້ນ. ສ້າງບົດລາຍງານໃຫ້
"bin_compat_report.html".

- ແຫຼ່ງ

ສະແດງບັນຫາຄວາມເຂົ້າກັນໄດ້ຂອງ "ແຫຼ່ງ" ເທົ່ານັ້ນ. ສ້າງບົດລາຍງານໃຫ້
"src_compat_report.html".

-v1|-version1 NUM

ລະບຸເວີຊັນ API ທີ 1 ຢູ່ນອກຕົວອະທິບາຍ. ທາງເລືອກນີ້ແມ່ນຈໍາເປັນຖ້າຫາກວ່າທ່ານມີ
ມັກປະເພດຕົວອະທິບາຍທາງເລືອກ (ເບິ່ງ -d1 ທາງ​ເລືອກ).

ໂດຍທົ່ວໄປແລ້ວທ່ານຄວນລະບຸມັນຢູ່ໃນຕົວອະທິບາຍ XML:



ເວີຊັ່ນ



-v2|-version2 NUM

ລະບຸເວີຊັນຫ້ອງສະໝຸດທີ 2 ຢູ່ນອກຕົວອະທິບາຍ.

-s|-ເຄັ່ງຄັດ

ປະຕິບັດການເຕືອນຄວາມເຂົ້າກັນໄດ້ API ທັງໝົດເປັນບັນຫາ.

- ຮັກ​ສາ​ພາຍ​ໃນ​

ຢ່າຂ້າມການກວດສອບຊຸດເຫຼົ່ານີ້:

*impl* *ພາຍໃນ* *ຕົວຢ່າງ* *com.oracle* *com.sun* *COM.rsa* *sun* *sunw*

-skip-ພາຍໃນ PATTERN

ຢ່າກວດເບິ່ງຊຸດພາຍໃນທີ່ກົງກັບຮູບແບບ.

- ຖິ້ມ|-dump-api ເສັ້ນທາງ

Dump library API ໄປຫາໄຟລ໌ຮູບແບບ TXT gzipped. ທ່ານສາມາດໂອນມັນໄປທຸກບ່ອນແລະຜ່ານ
ແທນທີ່ຈະເປັນຕົວອະທິບາຍ. ນອກຈາກນີ້ມັນອາດຈະຖືກນໍາໃຊ້ສໍາລັບການ debugging ເຄື່ອງມື. ເຂົ້າກັນໄດ້
ສະບັບ dump: 1.0<=V<=1.0

- ບັນ​ຊີ​ລາຍ​ການ​ຊັ້ນ​ຮຽນ​ PATH

ທາງ​ເລືອກ​ນີ້​ອະ​ນຸ​ຍາດ​ໃຫ້​ເພື່ອ​ລະ​ບຸ​ໄຟລ​໌​ທີ່​ມີ​ບັນ​ຊີ​ລາຍ​ການ​ຂອງ​ຊັ້ນ​ຮຽນ​ທີ່​ຄວນ​ຈະ​ໄດ້​ຮັບ​ການ​ກວດ​ສອບ​,
ຫ້ອງຮຽນອື່ນໆຈະບໍ່ຖືກກວດສອບ.

-annotations-list PATH

ລະບຸໄຟລ໌ທີ່ມີລາຍຊື່ຄໍາບັນຍາຍ. ເຄື່ອງມືຈະກວດເບິ່ງພຽງແຕ່ຫ້ອງຮຽນ
ຫມາຍເຫດໂດຍຄໍາບັນຍາຍຈາກບັນຊີລາຍຊື່ນີ້. ຫ້ອງຮຽນອື່ນຈະບໍ່ຖືກກວດ.

-skip-deprecated

ຂ້າມການວິເຄາະຂອງວິທີການ ແລະຊັ້ນຮຽນທີ່ເຊົາໃຊ້ແລ້ວ.

- ຂ້າມ​ຫ້ອງ​ຮຽນ​ PATH

ຕົວເລືອກນີ້ອະນຸຍາດໃຫ້ລະບຸໄຟລ໌ທີ່ມີບັນຊີລາຍຊື່ຂອງຫ້ອງຮຽນທີ່ບໍ່ຄວນຈະເປັນ
ກວດກາ.

-skip-packages PATH

ຕົວເລືອກນີ້ອະນຸຍາດໃຫ້ລະບຸໄຟລ໌ທີ່ມີບັນຊີລາຍຊື່ຂອງຊຸດທີ່ບໍ່ຄວນຈະເປັນ
ກວດກາ.

- ສັ້ນ PATH

ສ້າງບົດລາຍງານສັ້ນໂດຍບໍ່ມີພາກສ່ວນ 'ວິທີການເພີ່ມ'.

- ລາຍ​ງານ​ເສັ້ນ​ທາງ​ PATH

ເສັ້ນທາງໄປສູ່ບົດລາຍງານຄວາມເຂົ້າກັນໄດ້. ຄ່າເລີ່ມຕົ້ນ:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

-bin-report-path PATH

ເສັ້ນທາງໄປຫາບົດລາຍງານຄວາມເຂົ້າກັນໄດ້ "Binary". ຄ່າເລີ່ມຕົ້ນ:

compat_reports/LIB_NAME/V1_to_V2/bin_compat_report.html

-src-report-path PATH

ເສັ້ນທາງໄປຫາ "ແຫຼ່ງ" ລາຍງານຄວາມເຂົ້າກັນໄດ້. ຄ່າເລີ່ມຕົ້ນ:

compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html

-ໄວ

ການວິເຄາະໄວ. ຄົນພິການ:

- ການ​ວິ​ເຄາະ​ຊື່​ພາ​ລາ​ມິ​ເຕີ​ວິ​ທີ​ການ - ການ​ວິ​ເຄາະ​ຄຸນ​ຄ່າ​ພາກ​ສະ​ຫນາມ​ຫ້ອງ - ການ​ວິ​ເຄາະ​ຂອງ​
ການນໍາໃຊ້ວິທີການທີ່ບໍ່ມີຕົວຕົນເພີ່ມເຕີມ - ຄວາມແຕກຕ່າງຂອງວິທີການແລະຫ້ອງຮຽນທີ່ຖືກຍົກເລີກ

- ຄັດ

ເປີດໃຊ້ການຈັດລຽງຂໍ້ມູນໃນ API dumps.

- ສະ​ແດງ​ການ​ເຂົ້າ​ເຖິງ​

ສະແດງລະດັບການເຂົ້າເຖິງຂອງວິທີການທີ່ບໍ່ແມ່ນສາທາລະນະທີ່ລະບຸໄວ້ໃນບົດລາຍງານ.

-hide-ແມ່ແບບ

ເຊື່ອງຕົວກໍານົດການແມ່ແບບໃນບົດລາຍງານ.

-hide-packages

- ຫນ້ອຍ

ບໍ່​ໄດ້​ເຮັດ​ຫຍັງ.

-show-packages

ສະແດງຊື່ແພັກເກດໃນບົດລາຍງານ.

- ຮັບ​ຜົນ​ກະ​ທົບ​ຈໍາ​ກັດ​ ຈຳ ກັດ

ຈໍານວນສູງສຸດຂອງວິທີການທີ່ໄດ້ຮັບຜົນກະທົບທີ່ລະບຸໄວ້ພາຍໃຕ້ຄໍາອະທິບາຍຂອງການປ່ຽນແປງ
ພິມໃນບົດລາຍງານ.

ອື່ນໆ ທາງເລືອກ:
- ທົດສອບ

ດໍາເນີນການທົດສອບພາຍໃນ. ສ້າງສອງສະບັບທີ່ບໍ່ເຂົ້າກັນໄດ້ຂອງຫ້ອງສະຫມຸດຕົວຢ່າງແລະດໍາເນີນການ
ເຄື່ອງມືໃນການກວດສອບຄວາມເຂົ້າກັນໄດ້. ທາງເລືອກນີ້ອະນຸຍາດໃຫ້ກວດເບິ່ງວ່າເຄື່ອງມື
ເຮັດວຽກຢ່າງຖືກຕ້ອງໃນສະພາບແວດລ້ອມໃນປະຈຸບັນ.

-ແມງໄມ້

ໂໝດດີບັກ. ພິມຂໍ້ມູນດີບັກເທິງໜ້າຈໍ. ບັນທຶກຂັ້ນຕອນການວິເຄາະລະດັບປານກາງ
ໃນໄດເຣັກທໍຣີ debug:

debug/LIB_NAME/VER/

ຍັງພິຈາລະນາການນໍາໃຊ້ - ຖິ້ມ ທາງເລືອກສໍາລັບການ debugging ເຄື່ອງມື.

-ຫົວຂໍ້ NAME

ປ່ຽນຊື່ຫ້ອງສະໝຸດໃນຫົວຂໍ້ລາຍງານເປັນ NAME. ໂດຍຄ່າເລີ່ມຕົ້ນຈະຖືກສະແດງ a
ຊື່ທີ່ລະບຸໂດຍ -l ທາງເລືອກ.

-jdk-ເສັ້ນທາງ PATH

ເສັ້ນທາງໄປຫາຕົ້ນໄມ້ຕິດຕັ້ງ JDK (ຕົວຢ່າງ /usr/lib/jvm/java-7-openjdk-amd64).

ລາຍງານ:
ບົດລາຍງານຄວາມເຂົ້າກັນໄດ້ຈະຖືກສ້າງຂື້ນເພື່ອ:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

ອອກ ລະຫັດ:
0 - ເຂົ້າກັນໄດ້. ເຄື່ອງມືດັ່ງກ່າວໄດ້ດໍາເນີນການໂດຍບໍ່ມີຂໍ້ຜິດພາດໃດໆ. non-zero - ບໍ່ເຂົ້າກັນຫຼື
ເຄື່ອງ​ມື​ໄດ້​ດໍາ​ເນີນ​ການ​ທີ່​ມີ​ຄວາມ​ຜິດ​ພາດ​.

ເພີ່ມເຕີມ ຂໍ້ມູນ:
http://ispras.linuxbase.org/index.php/Java_API_Compliance_Checker
https://github.com/lvc/japi-compliance-checker

ໃຊ້ japi-compliance-checker ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net