Gonector 1.2

This ReadMe file contains some important information about Gonector, such as system requirements, installation guide, quick start, troubleshooting, license notice, contact information, and copyright statement.
 


Introduction

Gonector is a FileMaker Pro plugin. It allows You to develop applications for iOS devices with FileMaker Pro. These applications are able to control various devices like printers, scales, RFID readers and POS payment terminals. For terminal implementation please contact 24U for implementation support.


       

System requirements

System requirements:

Mac

Recommended: Any Intel Mac, 4 GB RAM, Mac OS X 10.12, FileMaker Pro 16 Advanced or later.

Minimum: Any Intel Mac, 4 GB RAM, Mac OS X 10.12, FileMaker Pro 16 Advanced or later.

Windows

Recommended: CPU: 1 GHz or faster x86- or x64-bit processor RAM: 2 GB or more, Windows 10 Pro Edition, FileMaker Pro 16 Advanced.

Minimum: CPU: 1 GHz or faster x86- or x64-bit processor RAM: 1 GB, Windows 7 SP1 Professional Edition, FileMaker Pro 16 Advanced.

iOS

Apple App Store Requirements

If you build an app for any Infinite Peripherals device and are going to distribute your app on the App Store, you will need to register the app with Infinite Peripherals in order to obtain MFi Authorization. You can do so through the Infinite Peripherals website at https://developer.ipcmobile.com/profile/. Infinite Peripherals will provide you with an identification number (PPID) that you have to include in review notes when submitting your app. Select "Yes" for the "Bluetooth feature" option when registering your app as some of the supported devices use Bluetooth with a non-standard profile for communication. More information about supported standard profiles is available at https://support.apple.com/en-us/HT204387.

You don't need MFi authorization for qIDmini, CUSTOM printers or BlueSnap because they are using verified protocols that are exempt from the MFi Authorization requirements. See https://mfi.apple.com/MFiWeb/getFAQ.action#4-0 for more info.

Installation for FileMaker Pro

To install Gonector, follow these steps:

  1. If you did not do this yet, download and open the Gonector distribution archive
  2. To install the plug-in, copy its binary file into Extensions directory. If you are not sure where the binary should be placed, see UsingFMPlugIns.html
  3. Restart or start the FileMaker Pro
  4. The plug-in should be visible in the "Plug-Ins" preference pane inside FileMaker Pro preferences (Mac OS X) / Edit -> Preferences (Windows)

Installation into FileMaker iOS App SDK

Easy installation

To create iOS applications it is necessary to use Xcode. Please follow guide bellow. To make this easy for You we provide a special server that makes all of this automatically. Simply go to Xgode and follow the steps.


Full installation

The iOS App SDK allows you to build a standalone iOS app from your FileMaker solution
Users can access your FileMaker solution on iPad and iPhone similar to other iOS apps without having to install FileMaker Go

To install Gonector, follow these steps:

  1. Create iOS Project using FileMaker iOSAppSDK by following instructions on FileMaker support website
  2. Add Swift support to created project:
    • Open created iOS Project ( <projectPath>/<appName>.xcodeproj )
    • Add new file: File -> New -> File... (or cmd + N )
    • Choose "Swift File" from iOS section
    • You can name it "SwiftHelper.swift" or similarly and store it under project directory
    • When prompted "Would you like to configure an Objective-C bridging header?" choose "Create Bridging Header"
  3. Update Info.plist:
    • Open created iOS Project ( <projectPath>/<appName>.xcodeproj )
    • Find project's Info.plist in Project Navigator ( "Custom Application Resources" -> "Info.plist" )
    • Right click Info.plist and choose "Open As" -> "Source Code"
    • Paste this snippet on end of line 5:
      <key>UISupportedExternalAccessoryProtocols</key>
      <array>
      	<string>com.custom.printeralt</string>
      	<string>com.custom.printer</string>
      	<string>com.custom.my3alt</string>
      	<string>com.custom.my3</string>
      	<string>com.custom.donglealt</string>
      	<string>com.custom.dongle</string>
      	<string>it.caenrfid.protocol</string>
      	<string>com.datecs.linea.pro.msr</string>
      	<string>com.datecs.linea.pro.bar</string>
      </array>
      <key>NFCReaderUsageDescription</key>
      <string>NFC Reading</string>
                
  4. Install Gonector:
    • Copy Gonector.fmplugin into <projectPath>/<appName>/Plug-Ins/ folder
    • If you want to test Gonector on iOS Simulator copy GonectorSimulator.fmplugin into <projectPath>/<appName>/Plug-Ins folder
  5. Get license for Gonector:
    • Buy iOS license from Gonector website
    • Inside Bundle ID text field, insert Bundle ID of your created iOS project (be careful: The license is bound to the this Bundle ID)
    • After successful payment, you will receive serial number (SN)
  6. Register Gonector with your SN:
    • Inside your FileMaker solution use Gonector_Register plugin function with SN given as first parameter

Quick Start

To learn how to use this plug-in it is recommended to open one of the examples from the Examples folder.
Consult plugin documentation for more information: GonectorSyntax.html.

If you are new to FileMaker plug-ins, start by checking the UsingFMPlugIns.html file inside the Documentation folder. It briefly explains what plug-ins are, why they are useful, and how they are usually used

Troubleshooting

Before you contact our technical support regarding problems or difficulties using Gonector, please check if your issue is not listed below:

macOS and Windows

Plug-In is not visible in the FileMaker Pro
Check if the plug-in binary is present in the one of "Extensions" folders of the FileMaker Pro.

All plug-in functions return an "?" as a result
Gonector is probably not installed or deactivated in your application preferences. Open the Application Preferences from the Edit menu, click on the "Plug-Ins" tab, and make sure that Gonector is there and that it is enabled.

iOS

Device with iOS cannot read RFID.

All plug-in functions return an "?" as a result

If your problem is not listed above or if the recommended solution does not work for you, please contact our technical support at http://www.24uSoftware.com/support.php for assistance.

Shareware Notice

Please note that Gonector product is SHAREWARE. That means it is not free and you have to pay a license fee if you want to keep it. You can install Gonector and try it out for the period of 14 days. After this period, Gonector can stop working and require a registration code. You will get your registration code after you pay for your license.

You can freely distribute Gonector as long as you distribute the original compacted archive untouched and you don't charge money for the distribution. If you want to distribute Gonector on a physical medium, such as CD-ROM, or if you want to distribute it in other form than the original compacted archive, you must ask for our permission. If you are a solution developer and want to bundle Gonector with your products please contact 24U Software.

Please find detailed registration instructions in the file named "HowToRegister.html".

iOS license Notice

iOS version of Gonector is licensed seperately and differenty from desktop version, please read more in "HowToRegister.html".

You can find detailed license terms in the file named "24U Software License Agreement.pdf". Individual license types are described in the file named "HowToRegister.html".

Contact Information

You can contact us at one of the following addresses. We prefer being contacted via e-mail, but you can use any other method if e-mail is not good enough for you.

E-mail:   info@24uSoftware.com   general information about our products and our company
eval@24uSoftware.com free evaluation codes registration
sales@24uSoftware.com paid licenses ordering and registration
support@24uSoftware.com technical support and bug reports
 
WWW: http://www.24uSoftware.com/
 
Phone: +420-224 910 892
Fax: +420-242 487 778
 
Snail mail: 24U Software
Skochovická 88
252 45  Zvole u Prahy
Czech Republic


24U Software
The software Gonector is copyright ©2001-2019 24U Software. All rights reserved.
Portions of the software are © 1984-2019 FileMaker, Inc. All rights reserved