Version 3.9.1
This is Phunware's iOS SDK for the Core module. Visit http://maas.phunware.com/ for more details and to sign up.
- iOS 10.0 or greater
- XCode 11 or greater
Phunware recommends using CocoaPods 1.10 or greater to integrate the framework. Simply add
pod 'PWCore'
to your podfile. NOTE: PWCore is a required dependency for all MaaS modules.
The following frameworks are required:
SystemConfiguration.framework
MobileCoreServices.framework
QuartzCore.framework
CoreTelephony.framework
Security.framework
The following frameworks are optional:
CoreLocation.framework
UIKit.framework
NOTE: CoreLocation is used for comprehensive analytics. Apple mandates that your app have a good reason for enabling location services. Apple will deny your app if location is not a core feature for your app.
PWCore documentation is included in the Documents folder in the repository as both HTML and as a .docset. You can also find the latest documentation here: http://phunware.github.io/maas-core-ios-sdk/
At the top of your application delegate implementation (.m) file, add the following:
#import <PWCore/PWCore.h>
Inside your application delegate, you will need to initialize MaaS Core in the application:didFinishLaunchingWithOptions: method:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// These values can be found for your application in the MaaS portal (http://maas.phunware.com/clients).
[PWCore setApplicationID:@"APPLICATION_ID"
setAccessKey:@"ACCESS_KEY"
signatureKey:@"SIGNATURE_KEY"];
...
}
Location authorization of "When In Use" or "Always" is encouraged when starting PWCore for analytics purposes. Please follow Apple's Best Practices for requesting location permissions.
PWCore uses the following third-party components. All components are prefixed so you won't have to worry about namespace collisions.
Component | Description | License |
---|---|---|
AFNetworking | A delightful iOS and OS X networking framework. | MIT |
TMCache | Fast parallel object cache for iOS and OS X. | Apache 2.0 |
SSZipArchive | Zipping and unzipping files for iOS and OS X. | MIT |
You understand and consent to Phunware’s Privacy Policy located at www.phunware.com/privacy. If your use of Phunware’s software requires a Privacy Policy of your own, you also agree to include the terms of Phunware’s Privacy Policy in your Privacy Policy to your end users.
Use of this software requires review and acceptance of our terms and conditions for developer use located at http://www.phunware.com/terms/