                          Phidget22 for macOS
                              Version 1.24


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

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

   This package supports macOS 10.11 and newer.


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 1 or 2 steps:
	
	1. 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.
   
    2. The Phidget USB Driver
	
	  Some (mostly older) Phidgets require a USB driver, while newer Phidgets do not. 
	 Older Phidgets are listed as 'HID' in the 'USB Stack' field on their product page 
	 specifications tab at https://www.phidgets.com while newer Phidgets are listed 
	 as 'PHIDUSB'. VINT Phidgets do not requires a kernel driver.
	 
	 To support USB Phidgets which require a 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.


	
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.xcframework
    - Core Phidget22 library, meant for embedding in Apps (@rpath)
	- Supports multi-platform development for macOS, macCatalyst
	
   libraries/[platform]/Phidget22.framework
    - Core Phidget22 library, meant for embedding in Apps (@rpath)
	
   libraries/[platform]/libphidget22.dylib
    - Core Phidget22 dynamic library, not normally needed
	
   libraries/macos/Phidget22Extra.framework
    - Core Phidget22 extras library, meant for embedding in Apps (@rpath)
	- This is required by the network server - contains some helper APIs.
	
   libraries/macos/libphidget22java.jnilib
   libraries/macos/phidget22.jar
    - 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
	
	
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 macOS:
    https://www.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg
	

