Get started quickly with the PbF SDK from Flic. This example project will create a simple iOS project to demonstrate how to use the PbF SDK with an application written in Swift. Use UI buttons to scan, discover, connect, disconnect, and forget Flic buttons.
To get started you will need to purchase a developer license for the Flic PbF program. There are other ways to interact with the Flic buttons besides theh PbF, but if you want to build your own custom app for the Flic buttons you will need the PbF developer license. Contact Flic for details: https://flic.io/business/solutions
Once you purchase your PbF license Flic will send you an email with instructions and a username/password for their website. They will also send you license keys to activate the PbF library.
To use this project you will need xCode running on an apple device plus at least one Flic button and the PbF developer license.
Also It would be a good idea to read the documentation on the flic button here: http://pbf-docs.flic.io/guidelines/index.html
In particular, I would read the section on privacy modes.
- First you will need to purchase a developer license for the Flic PbF program. They will send you an email with instructions and a username/password for their website. They will also send you license keys to use the PbF library.
- Download this xCode project into a fresh directory on your system.
- Add the PbF library to your xCode project.
- Go to the Flic developer site: http://pbf-docs.flic.io
- Download the PbF library. Click on the link called "PbF-lib-iOS-date...."
- You now have a ZIP file in your Download folder named fliclib....zip. Unzip that file and you will now see fliclib.framework
- Import fliclib.framework into your xCode project
- You will need to modify some of your xcode project settings after importing the fliclib.framework. You can find detailed instructions in their iOS tutorial at this link: http://pbf-docs.flic.io/guidelines/iOSTutorial.html
- Go to Project build settings and set "allow non-modular includes in framework modules" to Yes
- Go to Targets -> FlicTest -> General -> Linked Frameworks and Libraries, then remove fliclib.framework from that list
- Go to Targets -> FlicTest -> General -> Embedded Binaries, then click the + symbol and select fliclib
- The remaining steps of the iOS tutorial should be done already in this test project
- Install your PbF license keys. Just look for "appID" near the top of the file ViewController.swift
- Build and run. Note you cannot run this project on the simulator because bluetooth is required.
Note: As with all downloaded xCode projects, you will need to configure your application signing before you can build and run. Go into your target settings --> General --> Signing and select your team profile.
Note: You may also want to change other xCode settings such as deployment target.
Running the app is trivial, but sometimes the buttons can get into a state where they no longer connect. If you get into this state it may be because you told the app to forget a button and now you are trying to reconnect to that button. In this case you need to hold down the button for 6 seconds while the button is disconnected and the app is not scanning. This will put the button back into the 'public' mode.