Star Micronics Cloud Services iOS SDK User`s Manual
Contents
1. 2 3 Edit information property list 1 Click on the information property list file h SearchPrinterViewController h m SearchPrinterViewControaller m m main mi h ViewController h m ViewController m 2 Add the Supported external accessory protocols key Then click the triangle of this key and set the value for the Item to jp star m starpro Info plist OA g E mPOP SDK P mPOP SDK gt P Supporting Files Info plist gt No Selection Key Type Value Information Property List Dictionary 16 items Localization native development region string en Executable file String S EXECUTABLE_NAME Bundle identifier String jp star m PRODUCT_NAME rfe1034identifier InfoDictionary version String 6 0 Bundle name string S PRODUCT_NAME Bundle OS Type code String APPL 1 Bundle versions string short String 1 0 n Bundle creator OS Type code string TPT Bundle version String 1 Application requires iPhone environment Boolean YES Launch screen interface file base name string LaunchScreen Main storyboard file base name string Main b Required device capabilities Ss Array 1 item Supported external accessory protocols Array 1 item ie T A jp star m starpra UPPOrted intertace orientations Array 4 items Supported interface orientations iPad Array 4 items 3 You have finished editing the information property list 12 20 Aug 24 2015 2015 Star Micronics All rights reserved2. IBAction touchUpInsideCloudServicesButton id sender SMCloudServices showRegistrationView IBAction touchUpInsidePrintButton id sender BOOL receipt receiptSwitch On 2Se88 IBAction touchUplnsideCloudServicesButton id sender SMCloudServices showRegistrationView 4 Tap UlButton to show RegistrationView Star Cloud Services p F AReceipts STAR CLOUD ACIS It became possible to register the device with RegistrationView Please refer to Star Micronics Cloud Services for more information 16 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar 4 How to upload AllReceipts 4 1 Edit about upload to Star Micronics Cloud Services Below is a reference example of the Star AllReceipts iOS SDK 1 Click on the ViewController m e Main storypoara h SearchPrinterViewController h m SearchPrinterViewController m p Supporting Files E EAN r eE eT Te ees b p Aecem e Ea CoreBluetooth framework 2 Import the SMCloudServicess h Lt 15 import lt StarI0O SMPort h gt 16 1 18 19 20 import StarIO_Extension StarIoExt h J1 2 interface ViewController import SMCloudServices SMCSAIIReceipts h 3 Upload of generated the Bitmap Ullmage object commands appendData builder commands commands appendData SMCSAlLlReceipts uploadBitmap image infoImage generalInfo qrCode qrCode completion NSInteger statusCode NSErro
3. Sitar 3 How to use AllReceipts with RegistrationView To use the AllReceipts with RegistrationView the application under development needs a user interface to show RegisitrationView for device registration to the Star Micronics Cloud Services The Star AllReceipts iOS SDK project includes the settings to use AllReceipts with RegistrationView so you can directly test the SDK as it is However when you are building your own application it is necessary to add settings to the project for AllReceipts with RegistrationView 3 1 Append SMCloudServicesResources bundle 1 Click on the project eae P S AllReceiptsClie o Jf p E AllReceiptsClientA i 2 targets iOS SDK 8 4 2 Open a target Click the Build Phases tab and click the Copy Bundle Resources sA lt AllReceiptsClientA fi General Capabilities Info Build Settings Build Phases Bi PROJECT A AllReceiptsClientA gt Target Dependencies 0 ite _ AllReceiptsClientATests gt Compile Sources 5 items Y Link Binary With Libraries 4 items E SMCloudServices framework StarlO_Extension framework E StarlO framework CoreBluetooth framework a Y Copy Bundle Resources 4 items SMCloudService ources bundle Main storybgafd Launch reen xib 13 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar 3 Click the Add Other button pe ees e ms o e m o e o a a ee w Choos
4. SMCloudServices framework StarlO framework and StarlO_Extension framework Then click Open Tshe T5 5MCloudServices framework b StarlO_Extension framework StarlO framework ie 5 The framework is added to the project 8 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar Version up of SMCloudServices framework StarlO framework and StarlO_Extension framework 1 Delete SMCloudServices framework StarlO framework and StarlO_ Extension framework from your project 2 Copy new SMCloudServices framework StarlO framework and StarlO_Extension framework 3 Clean the Xcode project Run AR Test a6 LJ Profile 5 Analyze HB Build For Perform Action 4 Build the Xcode project Run a6 Fi Test a6 Profile a6 Analyze HB Build For a Perform Action bs To refer to the new SMCloudServices framework StarlO framework and StarlO_Extension framework without deleting the existing SMCloudServices framework StarlO framework and StarlO_Extension framework surely confirm the framework search path setting of the Xcode project If the old path of the SMCloudServices framework StarlO framework and StarlO_Extension framework remains in front of the framework serach path the previous SMCloudServices framework StarlO framework and StarlO_Extension framework will be used 9 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar 2 2 Add CoreBluetooth
5. tata waits CIAR ecole rA iip Contguraton bPolease Ho Cigato der Ley Raker EB ter cenenascine cutis 7 Lessla Ere tas Fapa fos een 4 Engish Daseking Lowguage Files Liisi Ts Vek Japon 1 Fie Loco a Wrap bes DEOD boial A yarab sted ard Label tracts s Mo Selection E Gace E cons x Button asd serga orate names ma target object ates ia beppeck Segenented Genial Cipla 1 mukiote angranta aac of re pa ee iy 108 S Auto C amp AD utpat C nEle 5 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar Running the project 1 Use the shortcut R or click Product in the top menu bar and then Run File Edit View Find Navigate Editor Product e20 PFP E AllReceiptsClientA gt z f Profile A E O ma a ADEDE ul lt Analyze OB AllReceiptsClientA Archive B 2 targets iOS SDK 8 4 EEP s sai ma uila For Perform Action a Target TARGET Build 36B 5s Deployment Target 7 0 AIR Clean THK J AIR stop dh rations Scheme gt Destination b Create Bot e Use Release Hal for cor 6 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar 2 Howto configuration AllReceipts Application The SMCloudServices framework StarlO framework and StarlO_Extension framework is already included when the Star AllReceipts iOS SDK is loaded in Xcode there s no need to include it again when testing our SDK H
6. Sitar Star Micronics Cloud Services IOS SDK User s Manual Aug 24 2015 General Outline This document provides information about the Star Micronics Cloud Services iOS SDK showing guidelines for our customers to build the Star Micronics Cloud Services applications Aug 24 2015 2015 Star Micronics All rights reserved Sitar Version History Release Date Update Aug 24 2015 1st Release 2 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar About this Manual This manual is designed to help you understand SMCloudServices framework and how to build an iOS application Communication with printers and print data generation make use of the StarlO framework and StarlO_Extension framework When you would like to know StarlO framework and StarlO_Extension framework details please download StarlO iOS SDK and Star mPOP iOS SDK and refer to the document included in the package It is important for the readers of this document to have understood the basics of the Objective C language because this document is prepared for such application developers Although this SDK is for iOS there are SDKs available for many different operating systems and programming languages at our website in the Developers section Check the Developers section of our site for the newest SDKs technical documentation FAQs and many more additional resources CAUTION e The information in this manual is subject to chan
7. dBitmap image diffusion NO width 384 bothScale NO 2inch 384dots commands appendData builder commands commands appendData SMCSAIIReceipts uploadBitmap image infolmage YES qrCode YES completion 4 NSInteger statusCode NSError error if error NSLog Failure Request error _statusCodeLabel text Error 19 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar else NSLog Status Code d int statusCode _statusCodeLabel text NSString stringWithFormat d int statusCode H commands appendBytes x1b x64 x03 length sizeof x1b x64 x03 1 CutPaper Feed amp Partial self blind YES ViewController sendCommands commands portName AppDelegate getPortName portSettings AppDelegate getPortSettings timeout 10000 self blind NO How to convert the Ulimage object to the Star Emulation Command and how to communicate with the printer Please download StarlO iOS SDK and Star mPOP iOS SDK and refer to the document 20 20 Aug 24 2015 2015 Star Micronics All rights reserved
8. e items to add Nal ral E Y B AllReceiptsClientA e starCloudServices framework b otarlO_Extension framework gt fea StarlO framework b CoreBluetooth framework I AllReceiptsClientA h AppDelegate h m AppDelegate m h ImageFunctions h m ImageFunctions m h SearchPrinterViewController h i m SearchPrinterViewController m 7 PI Supporting Files Info plist m main m Cancel 4 Browse to the location of where the Star AllReceipts iOS SDK was unzipped and select SoMCloudServicesResources bundle Then click Open MS AllReceiptsClientA gt E Headers Info oli I AllReceiptsClientA xcodeproj i Resources d Pm AllReceiptsClientATests 2 oMCloudServices SMCloudServices framework Pa Versions b StarlO_Extension framework StarlO framework T F F F 5 The bundle is added to the project 14 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar 3 2 Arrangement of the user interface to indicate View 1 For example arrange UlButton 1 07 Phi AllReceipts Client Cloud Services BT Star Micronics Receipt gt General Info aR Code amp Search Printer 2 Import the SMCloudServicess h 15 import lt Starl0 SMPort h 2 import StarlI0 Extension StarlIoExt h import SMCloudServices SMCloudServices h Aug 24 2015 2015 Star Micronics All rights reserved 15 20 Sqr 3 Paste the following code B BE
9. ecessugeceeseeseeeeas 19 Aug 24 2015 2015 Star Micronics All rights reserved 4 20 Sitar 1 Getting Started To build an iOS project Xcode are needed These tools are available in one package from the Apple Developer Site or Mac App Store It is important to note that in order to produce applications that will actually run on an iOS device you must be part of the Apple Developer Program which requires a yearly subscription While it is possible to obtain these tools from Mac App Store as Stated above your application will only be able to run in the iOS Simulator and will not install on an actual device It is assumed Xcode have already been installed on your Mac at this point Should you need assistance or additional information visit the Resources section of the Apple Developer Site How to open the Star AllReceipts iOS SDK project in Xcode 1 Unzip the Star iOS SDK folder and open it AllRecelpts AllReceipts SDK SDK zIp 2 Open AllReceiptsClientA xcodeproj BS StarlO_Ext n framework gt otarlO framework b starMicroni framework 3 Set the iOS Deployment Target to 7 0 or later ene F e aain I earan Finished nating A Pipal mers ont akrar Hea et amp mimin aBa atA SDO AJEle Areapris lt gt D 2 if at arad e Bs tages 9 0K a info Baid gariras deriity arai Taze PADJEOT Mara A Paapaa aie T Bapypnem Fanit B bes Abaoalt TARGETS z R MRD Pull Pat
10. framework 1 Click on the project AllReceiptsClie ff Jel 2 Open a target Click the Build Phases tab and click the ptsClientA gt i SMJ_Dev4_iPhone6Plus01 Finished running AllReceiptsClientA on SMJ_Dev4_iPhone6Plus01 J O01 lt AllReceiptsClientA O General Capabilities Info Build Settings Build Phases Bi gt PROJECT D AllReceiptsClientA gt Target Dependen 5 p a s _ AllReceiptsClientATests Y Link Binary With Libraries 4 items Name E SMCloudServices framewo Drag to reorder frameworks Y Copy Bundle Resources 4 items SMCloudServicesResources bundle in SMCloudServices framework Versions A Resources Main storyboard LaunchScreen xib Ea Images xcassets in AllReceiptsClientA Aug 24 2015 2015 Star Micronics All rights reserved Sitar 3 Select CoreBluetooth framework and click the Add button Choose frameworks and libraries to add Q fq AudioToolbox framework fq AudioUnit framework AVFoundation framework p AVKit framework bundlet o CarrierBundleuUtilities dylib CFNetwork framework E CloudKit framework CoreAudio framework CoreAudiokit framework 3 CoreData framework CoreFoundation framework CoreGraphics framework f Corelmage framework Pineal aesatinn fea enor Add Other Cancel 4 The framework is added to the project Aug 24 2015 2015 Star Micronics All rights reserved FA 11 20 Sitar
11. ge without notice e STAR MICRONICS CO LTD has taken every measure to provide accurate information but assumes no liability for errors or omissions e STAR MICRONICS CO LTD is not liable for any damages resulting from the use of information contained in this manual e Reproduction in whole or in part is prohibited 3 20 Aug 24 2015 2015 Star Micronics All rights reserved Contents 1 GGUS SAO E A E EEN AT EEE AEE EE AS 5 2 How to configuration AllReceipts Application cccccsssccccsssececeeseceeeeeeceeeeeseeeees 7 2 1 Add SMClOUdSEervices framework ccccsssccccsssececcsececcenseceeeeseceeeeeceeseeeeeeas 7 2 2 Add CoreBluetooth frameworK ccccccsssecccessecccceesccceseseceeseeceeeeesecesauaeess 10 2 3 Edit information property liSt ccccccssccccesseccceesecceeeesececseecesseeeceesenseeetes 12 3 How to use AllReceipts with RegistrationView cccccsssccccsssececcseceeeeeseeeseeneees 13 3 1 Append SMCloudServicesResources bundle cccccccssseceeeseeeesseeneseeeeeees 13 3 2 Arrangement of the user interface to indicate ViIEW ccccccsescseeeseeeeeeees 15 4 HOW to upload AIIRECEIPTS ccccceeseccccesscccceesececceeececeeesececeuececseneceeseueeeseeneces 17 4 1 Edit about upload to Star Micronics Cloud ServiCes cccccccssseeeeeeeseeeees 17 5 SMCSAIRGCOID S gen en ee 19 5 1 uploadBitmap Method cceccccsssececcesececeesececsesececeeecceeeen
12. owever when you are building your own application it is necessary to add the framework into it 2 1 Add SMCloudServices framework 1 Click on the project AllReceiptsClie d 2 targets iOS SDK 8 4 2 Open a target Click the Build Phases tab and click the ptsClientA gt 0 SMJ_Dev4_iPhone6Plus01 Finished running AllReceiptsClientA on SMJ_Dev4_iPhone6Plus01 J 28 lt 5 AllReceiptsClientA fl General Capabilities Info Build Settings Build Phases Bi PROJECT BS AllReceiptsClientA gt Target Dependen gt Compile Sources 5 items _ AllReceiptsClientATests Y Link Binary With Libraries 4 items SMCloudServices framewo Y Copy Bundle Resources 4 items SMCloudServicesResources bundile Main storyboard LaunchScreen xib SS Images xcassets 7 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar 3 Click the Add Other button F Choose frameworks and libraries to add 1 2 J igios 8 4 p Accelerate framework i Accounts framework AddressBook framework F m AddressBookUl framework AdSupport framework p AssetsLibrary framework mA E AudioToolbox framework faq AudioUnit framework AVFoundation framework faq AVKit framework bundle1 o CarrierBundleUtilities dylib p CFNetwork framework E CloudKit framework Add Other Cancel 4 Browse to the location of where the Star AllReceipts iOS SDK was unzipped and select
13. r error if error NSLog Failure Request error _statusCodeLabel text Error else NSLog Status Code d int statusCode _statusCodeLabel text NSString stringWithFormat d int statusCode 121 commands appendBytes x1b x64 x03 Length sizeof x1b x64 x03 1 CutPaper Feed amp Partial if receipt YES 17 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar Example IBAction touchUpInsidePrintButton id sender _statusCodeLabel text Ullmage image IlmageFunctions createlmageEnglish3inchRasterModeReceipt English NSMutableData commands NSMutableData alloc init if receipt YES ISCBBuilder builder StarloExt createCommandBuilder SCBFactoryEmulationStar builder appendBitmap image diffusion NO width 384 bothScale NO 2inch 384dots commands appendData builder commands commands appendData SMCSAIIReceipts uploadBitmap image infolmage YES qrCode YES completion 4 NSInteger statusCode NSError error if error NSLog Failure Request error _statusCodeLabel text Error else NSLog Status Code d int statusCode _statusCodeLabel text NSString stringWithFormat d int statusCode HI commands appendBytes x1b x64 x03 length sizeof x1b x64 x03 1 CutPaper Feed amp Partial self blind YES ViewController sendCommands command
14. s portName AppDelegate getPortName portSettings AppDelegate getPortSettings timeout 10000 self blind NO 18 20 Aug 24 2015 2015 Star Micronics All rights reserved Sitar 5 SMCSAIIReceipts Method a Name Description uploadBitmap Upload bitmap Ullmage object to the Star Micronics Cloud Services 5 1 uploadBitmap Method Upload bitmap Ullmage object to the Star Micronics Cloud Services Declaration NSData uploadBitmap Ullmage image infolmage BOOL infolmage qrCode BOOL qrCode completion void NSInteger statusCode NSError error completion Parameter Name Description Object type image Bitmap Ullmage object Ullmage infolmage Append the AllReceipts general information to the BOOL return value e YES Need NO No need qrCode Append the QR Code to the return value BOOL e YES Need e NO No need completion A block that is called after the uploaded void NSInteger statusCode NSError error Return value Description Object type Printed information by the Star Emulation Command about the upload NSData Example IBAction touchUpInsidePrintButton id sender _statusCodeLabel text Ullmage image ImageFunctions createlmageEnglish3inchRasterModeReceipt English NSMutableData commands NSMutableData alloc init if receipt YES ISCBBuilder builder StarloExt createCommandBuilder SCBFactoryEmulationStar builder aopen
Download Pdf Manuals
Related Search