Gonector 3.0

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

Introduction

Gonector is a framework for iOS that allows your FileMaker solutions to communicate with various devices: printers, scales, barcode scanners, RFID readers, and UVC cameras. It also exposes built-in utilities to FileMaker, such as text-to-speech, audio player, and NFC reader. For POS payment terminal implementation, please contact 24U support.

System Requirements


 
 
 
 
Recommended Minimum
Mac macOS Tahoe 26.5
Intel/Apple Silicon CPU
8 GB RAM
FileMaker Pro 26
macOS Big Sur 11.5
Intel/Apple Silicon CPU
2 GB RAM
FileMaker Pro 16 Advanced
Windows Windows 11
Intel/AMD 64-bit CPU
4 GB RAM
FileMaker Pro 26
Windows 10
Intel/AMD 64-bit CPU
1 GB RAM
FileMaker Pro 16 Advanced
iOS iOS 26
Claris iOSAppSDK 26.1
iOS 17.6
Claris iOSAppSDK 26.1

To build the iOS application by yourself, you will additionally need Xcode with Swift version 5 and an apple developer account for testing and deployment on a device.

Supported Peripherals

Check our device ReadMes for how to use Gonector with a peripheral. It also explains additional requirements for submitting to App Store.

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 window inside FileMaker Pro preferences (Mac OS X) / Edit -> Preferences (Windows)

Installation for iOSAppSDK

There are two ways how to build an iOS application with Gonector. You can either use the Claris iOS SDK and Xcode our, for a more user friendly experience, use our Xgode.

Xgode Instructions

  1. Zip latests iOS version of Plug-In
  2. Upload zipped Plug-In to Xgode
  3. In advanced options check:

Xcode Instructions

  1. Go through all the steps from Claris iOS App SDK Instructions

  2. Open Xcode

  3. Move your solution to the “Solution Files” and change “launchSolution” to your solution in the “configFile” file if you have not done so.

  4. Go to Project -> Signing & Capabilities -> + Capability

  5. Find “Near Field Communication Tag Reading” and add it

  6. Create a folder named Frameworks next to your Solution Files. Paste in the following frameworks and add them to your Xcode project

  7. Go to “Build Phases” and add the frameworks from step 6 to “Embed frameworks”.

  8. Add these items to “Supported external accessory protocols” in your Info.plist file:

    <array>
        <string>com.custom.dongle</string>
        <string>com.custom.donglealt</string>
        <string>com.custom.my3alt</string>
        <string>com.custom.my3</string>
        <string>com.custom.printer</string>
        <string>com.custom.printeralt</string>
        <string>it.caenrfid.protocol</string>
        <string>com.datecs.linea.pro.msr</string>
        <string>com.datecs.linea.pro.bar</string>
        <string>com.datecs.pengine</string>
        <string>com.datecs.pinpad</string>
        <string>com.datecs.printer.escpos</string>
        <string>com.datecs.printer.label.zpl</string>
        <string>com.datecs.iserial.communication</string>
        <string>com.ipc.imperea.controls</string>
        <string>com.ipc.imperea.bootloader</string>
        <string>com.motorolasolutions.scanner</string>
        <string>com.motorolasolutions.CS4070_ssi</string>
        <string>com.zebra.rfd8x00_easytext</string>
    </array>
  9. Moreover, add the following permission strings to your Info.plist file:

<key>NSBluetoothAlwaysUsageDescription</key>
<string>App needs bluetooth access to connect to nearby devices.</string>
<key>NSCameraUsageDescription</key>
<string>Gonector allows user to take pictures of built-in and external cameras.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Some connected devices may need to know your location.</string>
<key>NSMicrophoneUsageDescription</key>
<string>Gonector does not use microphone.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Gonector may save photos to photo library.</string>
<key>NFCReaderUsageDescription</key>
<string>Gonector allows user to read NFC and store their content in FileMaker text fields.</string>
<key>NSAppleMusicUsageDescription</key>
<string>Gonector can play sounds.</string>
  1. Select Automatic Signing under Signing & Capabilities. Use a certificate of your Apple Development Team.
  2. Connect your iPhone or iPad using USB and select it as a running destination.
  3. Build your application.
  4. If the run failed, you may need to trust the PC on your iPhone or iPad in your settings (under General/VPN & Device Management). Then build again.

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. If our troubleshooting guide fails to solve your issue, please contact our technical support at https://24usoftware.com/support for assistance.

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.

On desktop, all plug-in functions return “?” 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.

On iOS, all plug-in functions return “?” as a result

I cannot find my peripheral when I call Gonector_Get(“devices”)

My peripheral refuses to connect or behaves strangely

I cannot scan NFC tags

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 separately and differently 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.



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