{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"details","parameters":{"macroParams":{"hidden":{"value":"true"}},"macroMetadata":{"macroId":{"value":"87a661e756d05fd1bd12cfaccae13bfd"},"schemaVersion":{"value":"1"},"title":"Page Properties"}},"localId":"17fffc1f-97a7-4f7c-95c4-41fb645f36a9"},"content":[{"type":"table","attrs":{"layout":"default","localId":"3aced34c-0764-4c2b-9fab-3e91aa1472d5"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Status","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"status","attrs":{"color":"green","style":"bold","text":"approved","localId":"0da93d79-62ee-47a7-8f5c-4af32125c688"}},{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Approver","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"mention","attrs":{"id":"5f7b067fb61f66006f29d4bf","text":"@Nadzeya Karaban"}},{"text":" ","type":"text"}]}]}]}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"b2b09a9f-ba90-4881-818c-f95f32585e03"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"d86531b8-a7fe-4eb7-be5e-479c2f5b21cf"}},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Open images and PDF files from other apps","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to enable your app to open any kind of files that are identified by the OS as images or PDF files, follow these steps:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Register image and PDF file types","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the following to your ","type":"text"},{"text":"Info.plist","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"swift"},"content":[{"text":"CFBundleDocumentTypes\n\n \n CFBundleTypeIconFiles\n \n CFBundleTypeName\n PDF\n CFBundleTypeRole\n Viewer\n LSHandlerRank\n Alternate\n LSItemContentTypes\n \n com.adobe.pdf\n \n \n \n CFBundleTypeName\n Images\n CFBundleTypeRole\n Viewer\n LSHandlerRank\n Alternate\n LSItemContentTypes\n \n public.jpeg\n public.png\n public.tiff\n com.compuserve.gif\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also add these by going to your target’s ","type":"text"},{"text":"Info","type":"text","marks":[{"type":"strong"}]},{"text":" tab and entering the values into the ","type":"text"},{"text":"Document Types","type":"text","marks":[{"type":"strong"}]},{"text":" section.","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to initiate ","type":"text"},{"text":"Open with","type":"text","marks":[{"type":"code"}]},{"text":" from your app’s Documents folder, add ","type":"text"},{"text":"UISupportsDocumentBrowser","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.apple.com/documentation/bundleresources/information_property_list/uisupportsdocumentbrowser"}}]},{"text":" to your ","type":"text"},{"text":"Info.plist","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Documentation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Document types","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.apple.com/library/content/documentation/FileManagement/Conceptual/DocumentInteraction_TopicsForIOS/Articles/RegisteringtheFileTypesYourAppSupports.html"}}]},{"text":" from ","type":"text"},{"text":"Apple documentation","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Enable the “Open with (Share)” feature inside the Gini Bank SDK","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Please note that the “Open with (Share)” feature is disabled by default. You have to enable this feature as explained below.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"To enable Gini Bank SDK to handle files imported from other apps and show the ","type":"text"},{"text":"Open With tutorial","type":"text","marks":[{"type":"strong"}]},{"text":" in the ","type":"text"},{"text":"Help","type":"text","marks":[{"type":"strong"}]},{"text":" menu, it is necessary to indicate it in the ","type":"text"},{"text":"GiniBankConfiguration","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","attrs":{"language":"swift"},"content":[{"text":" let giniBankConfiguration = GiniBankConfiguration.shared\n ...\n ...\n giniBankConfiguration.openWithEnabled = true","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. Handle incoming images and PDF files","type":"text"}]},{"type":"paragraph","content":[{"text":"When your app is requested to handle an image or a PDF file, your ","type":"text"},{"text":"AppDelegate","type":"text","marks":[{"type":"code"}]},{"text":"’s ","type":"text"},{"text":"application(_:open:options:)","type":"text","marks":[{"type":"code"}]},{"text":" (","type":"text"},{"text":"Swift","type":"text","marks":[{"type":"strong"}]},{"text":") method is called. Use the supplied URL to create a document as shown later.","type":"text"}]},{"type":"paragraph","content":[{"text":"In some cases, especially when the ","type":"text"},{"text":"LSSupportsOpeningDocumentsInPlace","type":"text","marks":[{"type":"code"}]},{"text":" flag is enabled in your ","type":"text"},{"text":"Info.plist","type":"text","marks":[{"type":"code"}]},{"text":" file, reading data directly from the URL might fail. For that reason, ","type":"text"},{"text":"GiniCapture","type":"text","marks":[{"type":"code"}]},{"text":" uses the asynchronous ","type":"text"},{"text":"UIDocument","type":"text","marks":[{"type":"code"}]},{"text":" API internally which handles any of the potential security requirements.","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to determine that the file opened is valid (correct size, correct type, and number of pages below the threshold on PDF files), it is necessary to validate it before using it.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Gini Bank","type":"text"}]},{"type":"codeBlock","attrs":{"language":"swift"},"content":[{"text":"func application(_ app: UIApplication,\n open url: URL,\n options: [UIApplicationOpenURLOptionsKey: Any] = [:]) -> Bool { \n\n // 1. Build the document\n let documentBuilder = GiniCaptureDocumentBuilder(documentSource: .appName(name: sourceApplication))\n documentBuilder.importMethod = .openWith\n\n documentBuilder.build(with: url) { [weak self] (document) in\n\n guard let self = self else { return }\n\n // 2. Validate the document\n if let document = document {\n do {\n try GiniCapture.validate(document,\n withConfig: giniBankConfiguration.captureConfiguration())\n // Load the GiniCapture with the validated document\n } catch {\n // Show an error pointing out that the document is invalid\n }\n }\n }\n\n return true\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Documentation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AppDelegate resource handling","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1623112-application"}}]},{"text":" from ","type":"text"},{"text":"Apple Documentation","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Supported file formats","type":"text","marks":[{"type":"link","attrs":{"href":"http://developer.gini.net/gini-api/html/documents.html#supported-file-formats"}}]},{"text":" from the Gini API","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Open images from Photos app","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to enable your app to open images from Photos, implement a shared extension. ","type":"text"},{"text":"Share extensions","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.apple.com/library/archive/documentation/General/Conceptual/ExtensibilityPG/Share.html"}}]},{"text":", in particular, let you share content with your application.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Add a share extension to your project","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"File -> New -> Target","type":"text","marks":[{"type":"code"}]},{"text":" and select ","type":"text"},{"text":"Share Extension","type":"text","marks":[{"type":"code"}]},{"text":". Make sure you link it to the main app. When the system asks if you want to activate the ","type":"text"},{"text":"Share scheme","type":"text","marks":[{"type":"code"}]},{"text":", select ","type":"text"},{"text":"Activate","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Set the extension activation rule","type":"text"}]},{"type":"paragraph","content":[{"text":"Change the ","type":"text"},{"text":"NSExtensionActivationRule","type":"text","marks":[{"type":"code"}]},{"text":" in the ","type":"text"},{"text":"Info.plist","type":"text","marks":[{"type":"code"}]},{"text":" in your extension target. Check the example ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/gini/gini-mobile-ios/blob/main/BankSDK/GiniBankSDKExample/GiniBankSDKShareExtension/Info.plist"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. Handle the URL","type":"text"}]},{"type":"paragraph","content":[{"text":"Find the example implementation ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/gini/gini-mobile-ios/blob/main/BankSDK/GiniBankSDKExample/GiniBankSDKShareExtension/ShareViewController.swift#L41"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4. Pass the data from the extension to the main app","type":"text"}]},{"type":"paragraph","content":[{"text":"Here we connect the share extension directly to the main app using ","type":"text"},{"text":"AppGroups","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"UserDefaults","type":"text","marks":[{"type":"code"}]},{"text":". Add ","type":"text"},{"text":"AppGroups","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_application-groups"}}]},{"text":" to the capabilities of both the extension and main app using the same app group. Check the example ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/gini/gini-mobile-ios/blob/main/BankSDK/GiniBankSDKExample/GiniBankSDKShareExtension/ShareViewController.swift#L33"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5. Open the main app and retrieve the shared data","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register your app extension scheme in the URL types for the main app.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the main app from the ","type":"text"},{"text":"extension","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/gini/gini-mobile-ios/blob/main/BankSDK/GiniBankSDKExample/GiniBankSDKShareExtension/ShareViewController.swift#L61"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Handle the incoming URL from the app extension in ","type":"text"},{"text":"AppDelegate","type":"text","marks":[{"type":"code"}]},{"text":" and retrieve data from the shared ","type":"text"},{"text":"UserDefaults","type":"text","marks":[{"type":"code"}]},{"text":". The system delivers the URL to your app by calling your app delegate’s ","type":"text"},{"text":"application(_:open:options:)","type":"text","marks":[{"type":"code"}]},{"text":" method. You can check our example implementation ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/gini/gini-mobile-ios/blob/main/BankSDK/GiniBankSDKExample/GiniBankSDKExample/AppDelegate.swift#L29"}}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported