iOS POS Print SDK (Swift) Version 2.11
Release Notes
Citizen Systems Co., Ltd.
June 30, 2023
This SDK allows the development of iOS applications to control CITIZEN POS printers and peripherals connected to the printer. For inquiries regarding the use of automatic coin dispensers, please contact us separately.
Please refer to the following manual for usage:
- iOS POS Print SDK Swift Version Programming Manual
File Structure
- Library
- Swift 5.1 and later: XCFramework for Xcode 11.0 and later
- Swift 5.3 and later: XCFramework for Xcode 12.0 and later
- Manual: Programming Manual
- Sample: Sample Project (for Xcode 12.0 and later)
* Frameworks for Swift 5.0 and earlier have been discontinued from Version 2.11.
How to Obtain
You can obtain the software from the following download site.
https://www.citizen-systems.co.jp/printer/download/
Changes from Previous Versions
Version 2.11 (2023/06/30)
[Features Added]
- Added printerCheckEx and openDrawerEx methods for printer control.
- Added near-empty and drawer status to the status method for printer control.
- Added ErrorCodeExtended property for control of printer/line display/barcode scanner/automatic coin dispenser.
- Added model RT-N300/RAD-N300 for automatic coin dispensers.
[Bug Fixes]
- Modified to avoid the QOS_CLASS_USER_INTERACTIVE warning that appears when executing the connect method via Bluetooth/Lightning on iOS 16 and later.
- Improved response during continuous scans with the barcode scanner.
- Modified the endDeposit method for automatic coin dispenser control to refund the deposited bill type unless it goes directly into the collection vault when specified as CCH_CHAN_DEPOSIT_REPAY.
- Improved the process for retrieving internal information upon completion of the fixDeposit method for automatic coin dispenser control.
- Improved the notification for CCH_CHAN_STATUS_JAM in the status event of automatic coin dispenser control.
- Improved the initialization timing of the DeviceFunction property in automatic coin dispenser control.
- Fixed a bug where a crash could occur when executing dispenseCash, dispenseCashOutside, and collectCount methods in automatic coin dispenser control.
Version 2.10 (2022/04/08)
[Features Added]
- Added logging functionality.
- Added XCFramework for Swift 5.3 and later that is compatible with the M1 chip Simulator.
- Added models RT-380/RAD-380 for automatic coin dispensers.
- Added CassetteWait property for automatic coin dispenser control.
[Bug Fixes]
- Modified to notify waiting events for currency removal during deposits in automatic coin dispenser control.
- Improved processing in automatic coin dispenser control when communication is unstable.
Version 2.09 (2021/11/18)
[Features Added]
- Added printer compatible models CMP-20/30/20II/30II/40.
- Added fixDeposit method to automatic coin dispenser control.
- Added success argument to endDeposit method in automatic coin dispenser control.
- Added argument for retrieving cash inside the auxiliary storage to readCashCounts method in automatic coin dispenser control.
[Bug Fixes]
- Changed the LAN search method for CT-S2000/CT-S4000 to search via Bonjour service.
- Supported semi-transparent specification for images in printBitmap/printBitmapData and setBitmapNV methods for printer control.
- Disabled italic specification for printTextLocalFont method for iOS 13 and later to improve issues with italic settings.
Version 2.08 (2021/02/09)
[Features Added]
- Changed the Framework format to XCFramework for Swift 5.1 and later.
- Changed the sample project to XCFramework for Xcode 11.0 and later.
- Added printer models CL-E301/CT-E601.
- Added CMP_BM_MODE_GRAY16DOWNLOAD to the mode argument of printBitmap/printBitmapData methods for printer control.
[Bug Fixes]
- Improved address check during USB connection.
- Modified pauseDeposit method in automatic coin dispenser control to wait until completion of deposits.
Version 2.07 (2021/01/05)
Corrected the usage example of the connect method in the programming manual.
Version 2.07 (2020/10/05)
[Features Added]
- Supported USB connection (Lightning).
- Added printTextLocalFont method for printer control.
- Added setPrintCompletedTimeout method.
- Supported measurement error events for automatic coin dispensers.
[Bug Fixes]
- Fixed a bug where fonts were garbled when printing UTF-8 characters in Page Mode.
- Improved automatic adjustment time for print completion confirmation in printer control.
- Improved printer search during Network connection.
- Fixed issues with the reset and closeDataRead methods in automatic coin dispenser control.
Version 2.06 (2020/03/16)
[Features Added]
- Added Framework for Swift 5.1 and later supporting "Module Stability." Please use it according to your development environment.
- Changed the sample project for Xcode 11.0 and later.
[Bug Fixes]
- Fixed a bug where the supplyCounts method in automatic coin dispenser control could not correctly obtain the replenishment count.
- Improved printer search during Network connection.
Version 2.05 (2020/01/16)
[Features Added]
- Supported control of automatic coin dispensers for peripherals.
Version 2.04 (2019/12/12)
[Features Added]
- Enabled LAN model search for CT-S2000 and CT-S4000 with searchCitizenPrinter/searchESCPOSPrinter methods.
[Bug Fixes]
- Fixed page mode printing issues when using label paper in printer control.
Version 2.03 (2019/11/12)
[Features Added]
- Supported iOS 13.2 and iPad OS 13.2.
- Added Framework for Swift 5.1.2. Please use it according to your development environment.
- Changed the sample project for Xcode 11.2.


