                          Phidget22 for macOS
                              Version 1.6


   This package contains macOS development files, command lines tools, and
Applications for supporting Phidget22.

	
Requirements
============

    This package supports OS X 10.11 and newer. For older versions of Mac OS / OS X,
see the Mac OS 10.5 and Mac OS 10.7 installers.


Overview
========

   Traditionally, Phidgets has supported macOS development with a pkg installer.
The installer installs the Phidget USB driver, Phidget22 Frameworks(s), Java support,
Phidget network server, and Phidget control panel.

   macOS apps are built against the Phidget22.framework which is installed in
/Library/Frameworks - and so rely on users to have installed our installer.

   This package is for supporting standalone macOS App development, which doesn't
require our installer to be run.

   Supporting standalone apps requires 2 steps:
   
    1. The Phidget USB Driver
	
	 a. macOS 10.14 and older:
	 
	     The USB Driver is provided by Phidget.kext, which must be
	    installed into /Library/Extensions
		
	     We provide PhidgetSignedKEXT_10_11.pkg which can be included in your own
		installer pkg using productbuild.
		
	 b. macOS 10.15+:
	 
	     The USB Driver is provided by com.phidgets.driver.PhidgetUSBHIDDriver.dext
		which is placed in your App bundle within Contents/Library/SystemExtensions
		
		 This DriverKit extension has been signed and is ready to include in your
		Developer ID Apps for distribution outside of the App Store. Your app must
		include the System Extensions entitlement and provisioning profile.
		
		 Activate the Driver using the System Extension API.
	
	2. The Phidget22.framework
	
        This package contains versions of the Phidget22 Frameworks which are meant to
	   be embedded within an App bundle.
	   
	    If you are using Swift - import the Phidget22Swift pod with CocoaPods instead
	   of embedding the Phidget22 Framework.
	
   As you can see - Apps supporting macOS 10.14 and older require an installer to install
the kernel extension. Apps supporting 10.15+ can be truly self-contained.

	
Contents
========

   drivers/dext/com.phidgets.driver.PhidgetUSBHIDDriver.dext
    - DriverKit Extension, signed and ready to be included in your Apps
	- Supports macOS 10.15+

   drivers/dext/PhidgetUSBDriver.dmg
    - Contains an App which installs the dext
	- This app is Notarized and could be distributed to customers as is as a minimal driver installer
	- Supports macOS 10.15+
	
   drivers/kext/Phidget.kext
    - Kernel Extension - signed, could be distributed
	- Supports macOS 10.11+
	
   drivers/kext/PhidgetSignedKEXT_10_11.pkg
    - kext installer pkg - This is meant to be included in your installer using productbuild
	- The installer IS notarized, and could be run as is as a simple driver installer
	- Supports macOS 10.11+
	
   libraries/Phidget22.framework
    - Core Phidget22 library, meant for embedding in Apps (@rpath)
	
   libraries/Phidget22Extra.framework
    - Core Phidget22 extras library, meant for embedding in Apps (@rpath)
	- This is required by the network server - contains some unofficial helper APIs.
	
   libraries/libphidget22java.jnilib
    - Phidget22 JNI library, meant for embedding in Apps (@rpath)
	- This pairs with phidget22.jar to support Java
	
   programs/networkserver
    - Standalone version of the Phidget Network Server
	- This can by run on a system where Phidgets have not been installed - 
	   as long as the USB driver (kext or dext) HAS been installed
	
	
Online Resources
================

   macOS Support page:
    https://www.phidgets.com/docs/OS_-_macOS

   Latest Phidget22 dev files (this package):
    https://www.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip
	
   Latest Phidget22 installer for OS X 10.11+:
    https://www.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg
	
   Latest Phidget22 installer for Mac OS 10.7 - OS X 10.10:
    https://www.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_OS_X_10_7.dmg
	
   Latest Phidget22 installer for Mac OS 10.5 & Mac OS 10.6:
    https://www.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_OS_X_10_5.dmg
	

