Major Changes

This release is mostly about the Python, Android and iOS wrappers. The latter 2 have changed considerably to have an API that is more in line with each other and with the core c++ library. The changes will most likely break existing app code but set a proper foundation for the future.

• Python:

  • Multithreading Support via GIL by @billmccartney in Python Multithreading Support via GIL #616
  • Remove numpy requirement, use buffer protocol instead by @EchterAgo in Python: Remove numpy requirement, use buffer protocol instead #615
  • Support sliced numpy arrays
  • Expose return_errors parameter to Python wrapper APIs. by @gregtws in Expose return_errors parameter to Python wrapper APIs. #618
  • Expose Result::ecLevel method as python property by @marcoffee in Expose Result::ecLevel method as python property #600
  • Build wheels for Python 3.12. by @dainnilsson in Build wheels for Python 3.12. #625

• Android:

  • Android wrapper: Modernize build files by @okarmazin in Android wrapper: Modernize build files #619
  • Fix permissions on Android R+ by @markusfisch in Fix permissions on Android R+ #656
  • Android wrapper improvements by @markusfisch in Android wrapper improvements #659
  • android: add consumerProguardFiles by @markusfisch in android: add consumerProguardFiles #660
  • android: Fix build with NDK 26 by @michaelweghorn in android: Fix build with NDK 26 #674
  • Build with C++20 (improved DataMatrix detection) by default
  • Don't close() the ImageProxy inside read() anymore, need to do that outside now (this breaks existing code)
  • Change package name from com.zxingcpp to simply zxingcpp (breaking change)
  • publish library on mavenCentral for lowest possible barrier of entry

• iOS/macOS:

  • iOS Wrapper improvements by @benjohnde in iOS Wrapper improvements #630
  • iOS wrapper: Add functionality of encoding binary data into Barcodes by @alexmanzer in iOS wrapper: Add functionality of encoding binary data into Barcodes #635
  • Rename ZXingCppWrapper to ZXingCpp by @alexmanzer in Rename ZXingCppWrapper to ZXingCpp #638
  • iOS: Enable CocoaPods by providing a podspec by @benjohnde in iOS: Enable CocoaPods by providing a podspec #637
  • Build with C++20 (improved DataMatrix detection) by default
  • ios: specify EC level/margin for generation by @markusfisch in ios: specify EC level/margin for generation #644
  • ios: expose all native result items in wrapper by @markusfisch in ios: expose all native result items in wrapper #649
  • ios: clean up ZXIDecodeHints by @markusfisch in ios: clean up ZXIDecodeHints #652
  • ios: use a default error text instead of crashing by @markusfisch in ios: use a default error text instead of crashing #661
  • ios: improve exception handling by @markusfisch in ios: improve exception handling #664
  • ios: rename ZXIDecodingHints to ZXIReaderOptions

• General:

  • Rename DecodeHints to ReaderOptions. The old name is still available for backward API compatibility but deprecated. Since the C-API and the Qt wrapper code are not officially part of the library, they changed without backward compatibility.
  • WASM: bytes in ReadResult by @Sec-ant in WASM: bytes in ReadResult #588
  • DataMatrix: use charset for encoding by @markusfisch in DataMatrix: use charset for encoding #628
  • QRCode: Support QR Code Model1 by @sayzzy-nt in Support QR Code Model1 #633
  • rMQR Code: Support Rectangular Micro QR Code by @gitlost in Add support for Rectangular Micro QR Code (rMQR), pure only #681

Minor Changes and Fixes

• Fix QT 6 QML Crash & Enable QML Shape by @LeonnardoVerol in Fix QT 6 QML Crash & Enable QML Shape #597
• Python: Fix wrapper build on MSVC not having __cplusplus for BitHacks by @EchterAgo in Python: Fix wrapper build on MSVC not having __cplusplus for BitHacks #613
• Correctly handle supported image formats on Android APIs < 23 by @okarmazin in Correctly handle supported image formats on Android APIs < 23 #622
• Add DecodeHints.setMaxNumberOfSymbols() to C API by @siiky in Add DecodeHints.setMaxNumberOfSymbols() to C API #665
• aztec: on decoding check for padding bits after B/S by @gitlost in aztec: re [7a0de5b0] padding bits - can have 11 (check 5 -> 6) #671

New Contributors

• @Sec-ant made their first contribution in WASM: bytes in ReadResult #588
• @LeonnardoVerol made their first contribution in Fix QT 6 QML Crash & Enable QML Shape #597
• @EchterAgo made their first contribution in Python: Fix wrapper build on MSVC not having __cplusplus for BitHacks #613
• @billmccartney made their first contribution in Python Multithreading Support via GIL #616
• @gregtws made their first contribution in Expose return_errors parameter to Python wrapper APIs. #618
• @okarmazin made their first contribution in Android wrapper: Modernize build files #619
• @alexmanzer made their first contribution in Add required framework versions to MACOSX builds #624
• @dainnilsson made their first contribution in Build wheels for Python 3.12. #625
• @benjohnde made their first contribution in iOS Wrapper improvements #630
• @sayzzy-nt made their first contribution in Support QR Code Model1 #633
• @michaelweghorn made their first contribution in android: Fix build with NDK 26 #674

Full Changelog: v2.1.0...v2.2.0