Skip to content

ChenYilong/iOS10AdaptationTips

BranchesTags

Repository files navigation

iOS10AdaptationTips

Reference:iOS9AdaptationTips.

Notification

User Notifications : both a new and old framework

If you diff SDK 'iOS 10.0'(Xcode 8) and SDK 'iOS 9.0' with this command below, you will find six UIKit classes related to notifications are deprecated in SDK 'iOS 10.0'(Xcode 8) .

UIKit9Dir="/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/UIKit.framework"
UIKit10Dir="/Applications/Xcode-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/UIKit.framework"

OptIgnore=--ignore-matching-lines='//.*Copyright'
DIFFBIN=/usr/bin/diff
$DIFFBIN -U 1 -r -x '*.tbd' -x '*.modulemap' $OptIgnore $UIKit9Dir $UIKit10Dir|egrep -C 1 "NS_CLASS_DEPRECATED_IOS.*"|grep interface

All of them are:

  1. UILocalNotification
  2. UIMutableUserNotificationAction
  3. UIMutableUserNotificationCategory
  4. UIUserNotificationAction
  5. UIUserNotificationCategory
  6. UIUserNotificationSettings

Old api also works fine with SDK 'iOS 10.0'(Xcode 8) , but we had better use the APIs in the User Notifications framework instead.

In addation to these classes, the handleActionWithIdentifier:forLocalNotification:, handleActionWithIdentifier:forRemoteNotification:, didReceiveLocalNotification:withCompletion:, and didReceiveRemoteNotification:withCompletion: WatchKit methods. Use handleActionWithIdentifier:forNotification: and didReceiveNotification:withCompletion: instead. Also the notification-handling methods in WKExtensionDelegate, such as didReceiveRemoteNotification: and handleActionWithIdentifier:forRemoteNotification:. Instead of using these methods, first create a delegate object that adopts the UNUserNotificationCenterDelegate protocol and implement the appropriate methods. Then assign the delegate object to the delegate property of the singleton UNUserNotificationCenter object.

SDK 'iOS 10.0'(Xcode 8) introduces the User Notifications framework (UserNotifications.framework), independent from UIKit, which supports the delivery and handling of local and remote notifications. so it's' both a new and old framework. You use the classes of this framework to schedule the delivery of local notifications based on specific conditions, such as time or location. Apps and app extensions can use this framework to receive and potentially modify local and remote notifications when they are delivered to the user’s device.

Also introduced in SDK 'iOS 10.0'(Xcode 8) , the User Notifications UI framework (UserNotificationsUI.framework) lets you customize the appearance of local and remote notifications when they appear on the user’s device. You use this framework to define an app extension that receives the notification data and provides the corresponding visual representation. Your extension can also respond to custom actions associated with those notifications.

I'll introduce the User Notifications framework in two parts:

  1. Local Notification
  2. Remote Notification

LocalNotification : write everything in one place

Someone may have the same question with this guy: enter image description here

It is impossible for the first question, but local notification may be the best way to help you In terms of waking the app at a certain time, even a certain place. Because LocalNotification is just for scheduling the delivery of local notifications based on specific conditions, such as time or location.

LocalNotification has a limit, you can't trigger a block of code to run when the notification is fired. You can, however, trigger a block of code to execute with a UNNotificationAction by adding an action to your notification and using userNotificationCenter(_:didReceive:withCompletionHandler:) on UNUserNotificationCenter.currentNotificationCenter(). That is to say, it's impossiable to run a snippet in background at a certain time, without notifiying user. This feature is limited byond iOS8.

schedule the delivery of local notifications based on time

Big Diff:

  1. Now you can either present alert, sound or increase badge while the app is in foreground too with SDK 'iOS 10.0'(Xcode 8)
  2. Now you can handle all event in one place when user tapped (or slided) the action button, even while the app has already been killed.
  3. Support 3D touch instead of sliding gesture.
  4. Now you can remove specifical local notification just by one row code.
  5. Support Rich Notification with custom UI.

I write a Demo here: iOS10AdaptationTips .

With Swift implemation:

  1. import UserNotifications

    ///    Notification become independent from UIKit
@import UserNotifications;

  2. request authorization for localNotification

        let center = UNUserNotificationCenter.current()
    center.requestAuthorization(options: [.alert, .sound]) { (granted, error) in
        // Enable or disable features based on authorization.
    }

  3. schedule localNotification

  4. update application icon badge number

    @IBAction  func triggerNotification(){
    let content = UNMutableNotificationContent()
    content.title = NSString.localizedUserNotificationString(forKey: "Elon said:", arguments: nil)
    content.body = NSString.localizedUserNotificationString(forKey: "Hello Tom！Get up, let's play with Jerry!", arguments: nil)
    content.sound = UNNotificationSound.default()
    content.badge = UIApplication.shared().applicationIconBadgeNumber + 1;
    content.categoryIdentifier = "com.elonchan.localNotification"
    // Deliver the notification in five seconds.
    let trigger = UNTimeIntervalNotificationTrigger.init(timeInterval: 60.0, repeats: true)
    let request = UNNotificationRequest.init(identifier: "FiveSecond", content: content, trigger: trigger)

    // Schedule the notification.
    let center = UNUserNotificationCenter.current()
    center.add(request)
}

@IBAction func stopNotification(_ sender: AnyObject) {
    let center = UNUserNotificationCenter.current()
    center.removeAllPendingNotificationRequests()
    // or you can remove specifical notification:
    // center.removePendingNotificationRequests(withIdentifiers: ["FiveSecond"])
}

With Objective-C implemation:

  1. import UserNotifications

    ///    Notification become independent from UIKit
@import UserNotifications;

  2. request authorization for localNotification

    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
[center requestAuthorizationWithOptions:(UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert)
                      completionHandler:^(BOOL granted, NSError * _Nullable error) {
                          if (!error) {
                              NSLog(@"request authorization succeeded!");
                              [self showAlert];
                          }
                      }];

  3. schedule localNotification

  4. update application icon badge number

        //        //Deliver the notification at 08:30 everyday
    //        NSDateComponents *dateComponents = [[NSDateComponents alloc] init];
    //        dateComponents.hour = 8;
    //        dateComponents.minute = 30;
    //        UNCalendarNotificationTrigger *trigger = [UNCalendarNotificationTrigger triggerWithDateMatchingComponents:dateComponents repeats:YES];
    
    UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init];
    content.title = [NSString localizedUserNotificationStringForKey:@"Elon said:" arguments:nil];
    content.body = [NSString localizedUserNotificationStringForKey:@"Hello Tom！Get up, let's play with Jerry!"
                                                         arguments:nil];
    content.sound = [UNNotificationSound defaultSound];
    
    /// 4. update application icon badge number
    content.badge = NSNumber(integerLiteral: UIApplication.shared.applicationIconBadgeNumber + 1);
    // Deliver the notification in five seconds.
    UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger
                                                  triggerWithTimeInterval:5.f repeats:NO];
    UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:@"FiveSecond"
                                                                          content:content trigger:trigger];
    /// 3. schedule localNotification
    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
    [center addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
        if (!error) {
            NSLog(@"add NotificationRequest succeeded!");
        }
    }];

Go to here for more information: iOS10AdaptationTips .

updated:

Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'time interval must be at least 60 if repeating'

let trigger = UNTimeIntervalNotificationTrigger.init(timeInterval: 60, repeats: true)

then it will appear like this:

iOS Version iOS10 iOS9
Request Authorization enter image description here enter image description here
In Background enter image description here enter image description here
Lock Screen enter image description here enter image description here
If Repeat by default enter image description here enter image description here
3D Touch enter image description here not support
  1. Now you can either present alert, sound or increase badge while the app is in foreground too with SDK 'iOS 10.0'(Xcode 8)
  2. Now you can handle all event in one place when user tapped (or slided) the action button, even while the app has already been killed.
  3. Support 3D touch instead of sliding gesture.
  4. Now you can remove specifical local notification just by one row code.
- (void)stopNotification:(id)sender {
   if (SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(@"10.0")) {
       UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
       // remove all local notification:
//        [center removeAllPendingNotificationRequests];
       // or you can remove specifical local notification:
        [center removePendingNotificationRequestsWithIdentifiers:@[ CYLInviteCategoryIdentifier ]];
   } else {
       // remove all local notification:
//        [[UIApplication sharedApplication] cancelAllLocalNotifications];
       // or you can remove specifical local notification:
       NSString *specificalIDToCancel = CYLInviteCategoryIdentifier;
       UILocalNotification *notificationToCancel = nil;
       for(UILocalNotification *aNotif in [[UIApplication sharedApplication] scheduledLocalNotifications]) {
           if([[aNotif.userInfo objectForKey:@"CategoryIdentifier"] isEqualToString:specificalIDToCancel]) {
               notificationToCancel = aNotif;
               break;
           }
       }
       if(notificationToCancel) {
           [[UIApplication sharedApplication] cancelLocalNotification:notificationToCancel];
       }
   }
}

By the way, you can use this code to check Xcode Version:

#define XCODE_VERSION_GREATER_THAN_OR_EQUAL_TO_8    __has_include(<UserNotifications/UserNotifications.h>)

###Remote Push Notification

It's really samilar with Local Notification:

Reigster method may be the biggist different:

I'll show how to register with Objective-C method:

   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        [self registerForRemoteNotification];
        . . .
    }


    - (void)registerForRemoteNotification {
        if ([[UIDevice currentDevice].systemVersion floatValue] >= 10.0) {
            UNUserNotificationCenter *uncenter = [UNUserNotificationCenter currentNotificationCenter];
            [uncenter setDelegate:self];
            [uncenter requestAuthorizationWithOptions:(UNAuthorizationOptionAlert+UNAuthorizationOptionBadge+UNAuthorizationOptionSound)
                                    completionHandler:^(BOOL granted, NSError * _Nullable error) {
                                        [[UIApplication sharedApplication] registerForRemoteNotifications];
                                        NSLog(@"%@" , granted ? @"success to request authorization." : @"failed to request authorization .");
                                    }];
            [uncenter getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) {
                NSLog(@"%s\nline:%@\n-----\n%@\n\n", __func__, @(__LINE__), settings);
                if (settings.authorizationStatus == UNAuthorizationStatusNotDetermined) {
                    //TODO:
                } else if (settings.authorizationStatus == UNAuthorizationStatusDenied) {
                    //TODO:
                } else if (settings.authorizationStatus == UNAuthorizationStatusAuthorized) {
                    //TODO:
                }
            }];
        }
    #pragma clang diagnostic push
    #pragma clang diagnostic ignored "-Wdeprecated-declarations"
        if ([[UIDevice currentDevice].systemVersion floatValue] >= 8.0) {
            UIUserNotificationType types = UIUserNotificationTypeAlert |
                                           UIUserNotificationTypeBadge |
                                           UIUserNotificationTypeSound;
            UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:types categories:nil];

            [[UIApplication sharedApplication] registerUserNotificationSettings:settings];
            [[UIApplication sharedApplication] registerForRemoteNotifications];
        } else {
            UIRemoteNotificationType types = UIRemoteNotificationTypeBadge |
                                             UIRemoteNotificationTypeAlert |
                                             UIRemoteNotificationTypeSound;
            [[UIApplication sharedApplication] registerForRemoteNotificationTypes:types];
        }
    #pragma clang diagnostic pop
    }

Here is a demo: iOS10AdaptationTips.

schedule the delivery of local notifications based on location

If your iPhone installed Foursquare-app, you will deliver notification when you enters or leaves a geographic region. How to do that?

just trigger with this:

@interface UNLocationNotificationTrigger : UNNotificationTrigger

@property (NS_NONATOMIC_IOSONLY, readonly, copy) CLRegion *region;

+ (instancetype)triggerWithRegion:(CLRegion *)region repeats:(BOOL)repeats __WATCHOS_PROHIBITED;

@end

some little error

Check dependencies Signing for Your-Prject-Name requires a development team. Select a development team in the Target Editor. Warning: The Copy Bundle Resources build phase contains this target's Info.plist file '/Users//Info.plist'. Code signing is required for product type 'Application' in SDK 'iOS 10.0'

ATS

Reference : Security and Privacy Enhancements

Security

Access privacy-sensitive data

Before you access privacy-sensitive data like Camera, Contacts, and so on, you must ask for the authorization, your app will crash when you access them.Then Xcode will log like:

This app has crashed because it attempted to access privacy-sensitive data without a usage description. The app's Info.plist must contain an NSContactsUsageDescription key with a string value explaining to the user how the app uses this data.

How to deal with this? As apple say:

You must statically declare your app’s intended use of protected data classes by including the appropriate purpose string keys in your Info.plist file.

Open the file in your project named info.plist, right click it, opening as Source Code, paste this code below to it. Or you can open info.plist as Property List by default, click the add button, Xcode will give you the suggest completions while typing Privacy - with the help of keyboard ⬆️ and ⬇️.

The list of frameworks that count as private data is a long one:

Contacts, Calendar, Reminders, Photos, Bluetooth Sharing, Microphone, Camera, Location, Health, HomeKit, Media Library, Motion, CallKit, Speech Recognition, SiriKit, TV Provider.

Remember to write your description why you ask for this authorization, between <string> and </string>, or your app will be rejected by apple:

   <!-- 🖼 Photo Library -->
   <key>NSPhotoLibraryUsageDescription</key>
   <string>$(PRODUCT_NAME) photo use</string>
    
   <!-- 🖼 Photo Library -->
   <key>NSPhotoLibraryAddUsageDescription</key>
   <string>$(PRODUCT_NAME) photo use</string>

   <!-- 📷 Camera -->
   <key>NSCameraUsageDescription</key>
   <string>$(PRODUCT_NAME) camera use</string>
   
   <!-- 🎤 Microphone -->
   <key>NSMicrophoneUsageDescription</key>
   <string>$(PRODUCT_NAME) microphone use</string>
   
   <!-- 📍 Location -->
   <key>NSLocationUsageDescription</key>
   <string>$(PRODUCT_NAME) location use</string>
   
   <!-- 📍 Location When In Use -->
   <key>NSLocationWhenInUseUsageDescription</key>
   <string>$(PRODUCT_NAME) location use</string>
   
   <!-- 📍 Location Always -->
   <key>NSLocationAlwaysUsageDescription</key>
   <string>$(PRODUCT_NAME) always uses location </string>

   <!-- 📆 Calendars -->
   <key>NSCalendarsUsageDescription</key>
   <string>$(PRODUCT_NAME) calendar events</string>

   <!-- ⏰ Reminders -->
   <key>NSRemindersUsageDescription</key>
   <string>$(PRODUCT_NAME) reminder use</string>
   
   <!-- 📒 Contacts -->
   <key>NSContactsUsageDescription</key>
   <string>$(PRODUCT_NAME) contact use</string>

   <!-- 🏊 Motion -->
   <key>NSMotionUsageDescription</key>
   <string>$(PRODUCT_NAME) motion use</string>
   
   <!-- 💊 Health Update -->
   <key>NSHealthUpdateUsageDescription</key>
   <string>$(PRODUCT_NAME) heath update use</string>
   
   <!-- 💊 Health Share -->
   <key>NSHealthShareUsageDescription</key>
   <string>$(PRODUCT_NAME) heath share use</string>
   
   <!-- ᛒ🔵 Bluetooth Peripheral -->
   <key>NSBluetoothPeripheralUsageDescription</key>
   <string>$(PRODUCT_NAME) Bluetooth Peripheral use</string>

   <!-- 🎵 Media Library -->
   <key>NSAppleMusicUsageDescription</key>
   <string>$(PRODUCT_NAME) media library use</string>

   <!-- 📱 Siri -->
   <key>NSSiriUsageDescription</key>
   <string>$(PRODUCT_NAME) siri use</string>

   <!-- 🏡 HomeKit -->
   <key>NSHomeKitUsageDescription</key>
   <string>$(PRODUCT_NAME) home kit use</string>

   <!-- 📻 SpeechRecognition -->
   <key>NSSpeechRecognitionUsageDescription</key>
   <string>$(PRODUCT_NAME) speech use</string>

   <!-- 📺 VideoSubscriber -->
   <key>NSVideoSubscriberAccountUsageDescription</key>
   <string>$(PRODUCT_NAME) tvProvider use</string>

If it does not works, try to ask for the the background authorization:

<key>UIBackgroundModes</key>
<array>
   <!-- something you should use in background -->
   <string>location</string>
</array>

Or go to target -> Capabilities -> Background Modes -> open the background Modes:

enter image description here

then clean your Project, run it. Reference:

You can work with AutoresizingMask and Autolayout Constraints at the same time in Xib and Storyboard

Even iOS6 has give a compatibility to let developer work with AutoresizingMask and Autolayout Constraints together, Xcode can translates AutoresizingMask code into Constraints, but it does not work with Xib or Storyboard.

@interface UIView (UIConstraintBasedCompatibility) 

/* By default, the autoresizing mask on a view gives rise to constraints that fully determine 
the view's position. This allows the auto layout system to track the frames of views whose 
layout is controlled manually (through -setFrame:, for example).
When you elect to position the view using auto layout by adding your own constraints, 
you must set this property to NO. IB will do this for you.
*/
@property(nonatomic) BOOL translatesAutoresizingMaskIntoConstraints NS_AVAILABLE_IOS(6_0); // Default YES
@end

But now Xcode8 can translate AutoresizingMask into Autolayout Constraints, so you can work with AutoresizingMask and Autolayout Constraints in Xib or Storyboard at the same time.

iOS Version Checking

Do not do this below to check the iOS version in your app:

#define IsIOS7 ([[[[UIDevice currentDevice] systemVersion] substringToIndex:1] intValue]>=7)

It will always return NO, substringToIndex:1 in SDK 'iOS 10.0'(Xcode 8) means SDK 'iOS 1.0'.

Use this instead:

Objective-C:

#define SYSTEM_VERSION_EQUAL_TO(v)                  ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedSame)
#define SYSTEM_VERSION_GREATER_THAN(v)              ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedDescending)
#define SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(v)  ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] != NSOrderedAscending)
#define SYSTEM_VERSION_LESS_THAN(v)                 ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedAscending)
#define SYSTEM_VERSION_LESS_THAN_OR_EQUAL_TO(v)     ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] != NSOrderedDescending)

Or:

//App Deployment Target should be beyond 8.0:
if ([[NSProcessInfo processInfo] isOperatingSystemAtLeastVersion:(NSOperatingSystemVersion){.majorVersion = 9, .minorVersion = 1, .patchVersion = 0}]) {
   NSLog(@"Hello from > iOS 9.1");
}

// Using short-form for the struct, we can make things somewhat more compact:
if ([NSProcessInfo.processInfo isOperatingSystemAtLeastVersion:(NSOperatingSystemVersion){9,3,0}]) {
   NSLog(@"Hello from > iOS 9.3");
}

Or:

//App Deployment Target should be beyond 2.0:
if (NSFoundationVersionNumber > NSFoundationVersionNumber_iOS_9_0) {
   // do stuff for iOS 9 and newer
} else {
   // do stuff for older versions than iOS 9
}

SDK 'iOS 10.0' (Xcode 8) gives more version numbers even future version.

#define NSFoundationVersionNumber_iOS_9_0 1240.1
#define NSFoundationVersionNumber_iOS_9_1 1241.14
#define NSFoundationVersionNumber_iOS_9_2 1242.12
#define NSFoundationVersionNumber_iOS_9_3 1242.12
#define NSFoundationVersionNumber_iOS_9_4 1280.25
#define NSFoundationVersionNumber_iOS_9_x_Max 1299

Swift:

if NSProcessInfo().isOperatingSystemAtLeastVersion(NSOperatingSystemVersion(majorVersion: 10, minorVersion: 0, patchVersion: 0)) {
   // modern code
}

Or:

if #available(iOS 10.0, *) {
   // modern code
} else {
   // Fallback on earlier versions
}

iOS10 Dealing With Untrusted Enterprise Developer

Since iOS9, there is no more “trust” option for an enterprise build.

Users have to do the configuration themselves: Go to Settings - General - Profiles - tap on your Profile - tap on Trust button. Reference.

but iOS10 has a little change,

Users should go to Settings - General - Device Management - tap on your Profile - tap on Trust button.

enter image description here

Reference:Efficient iOS Version Checking.

#【Chinese】 iOS10适配系列教程

多谢 @BaihaoTian 为本教程（英文版）提供了中文版本，详情见地址：《iOS10适配系列教程 中文版》。本教程优先更新英文版本，如果发现中文教程较旧，欢迎提PR。

###Notification

####User Notifications : both a new and old framework

如果你使用如下的命令对比SDK‘iOS10.0’(Xcode8)和SDK‘iOS9.0’的不同，你会发现有6个UIKit类关联通知的类在SDK‘iOS10.0’(Xcode8)废弃了。

UIKit9Dir="/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/UIKit.framework"
UIKit10Dir="/Applications/Xcode-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/UIKit.framework"

OptIgnore=--ignore-matching-lines='//.*Copyright'
DIFFBIN=/usr/bin/diff
$DIFFBIN -U 1 -r -x '*.tbd' -x '*.modulemap' $OptIgnore $UIKit9Dir $UIKit10Dir|egrep -C 1 "NS_CLASS_DEPRECATED_IOS.*"|grep interface

包含如下这些:

  1. UILocalNotification

  2. UIMutableUserNotificationAction

  3. UIMutableUserNotificationCategory

  4. UIUserNotificationAction

  5. UIUserNotificationCategory

  6. UIUserNotificationSettings

旧的接口也能在SDK‘iOS10.0’(Xcode8)中正常使用，但我们最好开始使用User Notifications framework中的APIs去替代老的接口。

除了这些类以外，这些handleActionWithIdentifier:forLocalNotification:, handleActionWithIdentifier:forRemoteNotification:, didReceiveLocalNotification:withCompletion :方法,和WatchKit中的方法 didReceiveRemoteNotification:withCompletion :，将会被handleActionWithIdentifier:forNotification:,didReceiveNotification:withCompletion:代替。此外在WKExtensionDelegate中notification的处理方法，比如didReceiveRemoteNotification :和handleActionWithIdentifier:forRemoteNotification:。取代使用这些方法的的是，首先穿件一个delegate实现UNUserNotificationCenterDelegate的协议然后选择实现合适的方法。

SDK'iOS 10.0'(Xcode 8) 引入了 从UIKit独立出来的User NOtification framework(UserNotifications.framework),从而支持了传输和处理本地和远程通知。所以可以说他是一个既新鲜又传统的framework。你可以使用这个framework的类基于更具体的情况去有计划的传输本地通知，比如时间或者定位。当通知传送到用户的设备上时，Apps和app extensions 可以使用这个framework去接收和潜在的修改本地通知或远程通知。

此外，SDK'iOS 10.0'(Xcode 8) 也引入了User Notifications UI framework (UserNotificationsUI.framework) 允许你定制本地或远程通知出现在你的设备上时的外观。你可以通过使用这个framework区定义一个app extension去接受通知的数据然后提供一个与数据符合的可视化外观。当然这个app extension也能响应和这个通知结合的定制的响应动作。

我将分两个部分介绍这个User Notifications framework:

  1. 本地通知

  2. 远程通知

####本地通知，可以把任何东西写在一个地方。

一些人可能和这位朋友有同样的问题：

第一个问题几乎是不可能直接解决的，但是通过本地通知从某种角度而言也许是最好的方式去在特定的时间甚至是特定的位置去唤醒你的app。这是因为本地通知就是通过特定的条件比如时间或定位来有计划的传送本地通知。

本地通知有一个局限，你不能触发并执行一段block在通知射出的时候(notification fired 这个老美对弹出通知是这么写的)。 然而你可以通过UNNotificationAction添加一个action到你的通知然后利用 serNotificationCenter(_:didReceive:withCompletionHandler:), UNUserNotificationCenter.currentNotificationCenter() 触发并执行一段代码块。也就是说，在不通知用户的情况下，固定的时间在后台执行一段脚本是不可能的。这个特征限制在iOS8以后。

####通过时间来有计划的发送本地通知 大不同：

  1. 在SDK‘iOS10.0’（Xcode）中，即使app在前台你也可以展示alert、播放声音、增加角标了。

  2. 现在当用户点击或者活动通知时，你可以在一个地方处理上述的任何事件了，甚至是这app被杀掉了。

  3. 支持3DTouch替代手势滑动了。

  4. 你现在通过仅仅一行代码就能移除特殊的本地通知。

通过OC实现的例子，iOS10AdaptationTips

1.引入 UserNotifications

///    Notification become independent from UIKit
@import UserNotifications;

2.为本地通知请求授权

UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
[center requestAuthorizationWithOptions:(UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert)
                      completionHandler:^(BOOL granted, NSError * _Nullable error) {
                          if (!error) {
                              NSLog(@"request authorization succeeded!");
                              [self showAlert];
                          }
                      }];

3.计划本地通知

4.更新应用红点

    //        //Deliver the notification at 08:30 everyday
    //        NSDateComponents *dateComponents = [[NSDateComponents alloc] init];
    //        dateComponents.hour = 8;
    //        dateComponents.minute = 30;
    //        UNCalendarNotificationTrigger *trigger = [UNCalendarNotificationTrigger triggerWithDateMatchingComponents:dateComponents repeats:YES];

    UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init];
    content.title = [NSString localizedUserNotificationStringForKey:@"Elon said:" arguments:nil];
    content.body = [NSString localizedUserNotificationStringForKey:@"Hello Tom！Get up, let's play with Jerry!"
                                                         arguments:nil];
    content.sound = [UNNotificationSound defaultSound];

    /// 4. update application icon badge number
    content.badge = @([[UIApplication sharedApplication] applicationIconBadgeNumber] + 1);
    // Deliver the notification in five seconds.
    UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger
                                                  triggerWithTimeInterval:5.f repeats:NO];
    UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:@"FiveSecond"
                                                                          content:content trigger:trigger];
    /// 3. schedule localNotification
    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
    [center addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
        if (!error) {
            NSLog(@"add NotificationRequest succeeded!");
        }
    }];

然后他就会如下图所示：

iOS Version iOS 10 iOS 9
Request Authorization
In Background
Lock Screen
If Repeat by default
3D Touch not support

1.现在通过SDK‘iOS10.0’(Xcode)即使app在前台运行你也能弹出alert，播放声音和增加角标。

2.现在当用户点击或者活动通知时，你可以在一个地方处理上述的任何事件了，即使这app被杀掉了。

3.支持3DTouch替代手势滑动了。

4.你现在通过仅仅一行代码就能移除特殊的本地通知。

- (void)stopNotification:(id)sender {
if (SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(@"10.0")) {
    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
    // remove all local notification:
//        [center removeAllPendingNotificationRequests];
    // or you can remove specifical local notification:
     [center removePendingNotificationRequestsWithIdentifiers:@[ CYLInviteCategoryIdentifier ]];
} else {
    // remove all local notification:
//        [[UIApplication sharedApplication] cancelAllLocalNotifications];
    // or you can remove specifical local notification:
    NSString *specificalIDToCancel = CYLInviteCategoryIdentifier;
    UILocalNotification *notificationToCancel = nil;
    for(UILocalNotification *aNotif in [[UIApplication sharedApplication] scheduledLocalNotifications]) {
        if([[aNotif.userInfo objectForKey:@"CategoryIdentifier"] isEqualToString:specificalIDToCancel]) {
            notificationToCancel = aNotif;
            break;
        }
    }
    if(notificationToCancel) {
        [[UIApplication sharedApplication] cancelLocalNotification:notificationToCancel];
    }
}
}

顺便说下，你可以使用如下代码检查Xcode的版本：

#define XCODE_VERSION_GREATER_THAN_OR_EQUAL_TO_8    __has_include(<UserNotifications/UserNotifications.h>)

通过定位有计划地发送本地通知

如果你的 iPhone 安装了 Foursquare-app(一款国外app类似大众点评)，当你进入或离开某个地理范围你会收到通知。这是怎么实现的呢？

“Trigger”时使用下面的方法就可以:

@interface UNLocationNotificationTrigger : UNNotificationTrigger

@property (NS_NONATOMIC_IOSONLY, readonly, copy) CLRegion *region;

+ (instancetype)triggerWithRegion:(CLRegion *)region repeats:(BOOL)repeats __WATCHOS_PROHIBITED;

@end

###一些小问题

Check dependencies Signing for Your-Prject-Name requires a development team. Select a development team in the Target Editor. Warning: The Copy Bundle Resources build phase contains this target's Info.plist file '/Users//Info.plist'. Code signing is required for product type 'Application' in SDK 'iOS 10.0'

####ATS Reference:Security and Privacy Enhancements

译者自己补充（iOS 9中默认非HTTPS的网络是被禁止的，当然我们也可以把NSAllowsArbitraryLoads设置为YES禁用ATS。不过iOS 10从2017年1月1日起苹果不允许我们通过这个方法跳过ATS，也就是说强制我们用HTTPS，如果不这样的话提交App可能会被拒绝。但是我们可以通过NSExceptionDomains来针对特定的域名开放HTTP可以容易通过审核。）

Security 安全

#####Access privacy-sensitive data 隐私及敏感数据访问权限

在你访问照相机、通讯录、等等隐私以及敏感数据之前，你必须请求授权。否则你的app会在你尝试访问这些隐私时崩溃。Xcode会log这些：

This app has crashed because it attempted to access privacy-sensitive data without a usage description. The app's Info.plist must contain an NSContactsUsageDescription key with a string value explaining to the user how the app uses this data.

怎么处理这个问题呢？

打开你工程中名叫 info.plist 的文件，右键点击选择 opening as Source Code，把下面的代码粘贴进去。或者你可以使用默认的 Property List 打开 info.plist，点击add按钮，当你输入 Privacy - Xcode会给你自动补全的建议，用上下键去选择吧。

私有数据的框架列表可是个不小的东西：

通讯录 日历 提醒 照片 蓝牙共享 耳机 相机 定位 健康 homeKit 多媒体库 运动 callKit 语音识别 SiriKit TV Provider

记得把你关于为什么申请授权的描述写进 plist 相关 key 的 <string> 和 </string> 中间，否则你的 App 会被拒。

   <!-- 🖼 Photo Library -->
   <key>NSPhotoLibraryUsageDescription</key>
   <string>$(PRODUCT_NAME) photo use</string>

   <!-- 🖼 Photo Library -->
   <key>NSPhotoLibraryAddUsageDescription</key>
   <string>$(PRODUCT_NAME) photo use</string>

   <!-- 📷 Camera -->
   <key>NSCameraUsageDescription</key>
   <string>$(PRODUCT_NAME) camera use</string>

   <!-- 🎤 Microphone -->
   <key>NSMicrophoneUsageDescription</key>
   <string>$(PRODUCT_NAME) microphone use</string>

   <!-- 📍 Location -->
   <key>NSLocationUsageDescription</key>
   <string>$(PRODUCT_NAME) location use</string>

   <!-- 📍 Location When In Use -->
   <key>NSLocationWhenInUseUsageDescription</key>
   <string>$(PRODUCT_NAME) location use</string>

   <!-- 📍 Location Always -->
   <key>NSLocationAlwaysUsageDescription</key>
   <string>$(PRODUCT_NAME) always uses location </string>

   <!-- 📆 Calendars -->
   <key>NSCalendarsUsageDescription</key>
   <string>$(PRODUCT_NAME) calendar events</string>

   <!-- ⏰ Reminders -->
   <key>NSRemindersUsageDescription</key>
   <string>$(PRODUCT_NAME) reminder use</string>

   <!-- 📒 Contacts -->
   <key>NSContactsUsageDescription</key>
   <string>$(PRODUCT_NAME) contact use</string>

   <!-- 🏊 Motion -->
   <key>NSMotionUsageDescription</key>
   <string>$(PRODUCT_NAME) motion use</string>

   <!-- 💊 Health Update -->
   <key>NSHealthUpdateUsageDescription</key>
   <string>$(PRODUCT_NAME) heath update use</string>

   <!-- 💊 Health Share -->
   <key>NSHealthShareUsageDescription</key>
   <string>$(PRODUCT_NAME) heath share use</string>

   <!-- ᛒ🔵 Bluetooth Peripheral -->
   <key>NSBluetoothPeripheralUsageDescription</key>
   <string>$(PRODUCT_NAME) Bluetooth Peripheral use</string>

   <!-- 🎵 Media Library -->
   <key>NSAppleMusicUsageDescription</key>
   <string>$(PRODUCT_NAME) media library use</string>

   <!-- 📱 Siri -->
   <key>NSSiriUsageDescription</key>
   <string>$(PRODUCT_NAME) siri use</string>

   <!-- 🏡 HomeKit -->
   <key>NSHomeKitUsageDescription</key>
   <string>$(PRODUCT_NAME) home kit use</string>

   <!-- 📻 SpeechRecognition -->
   <key>NSSpeechRecognitionUsageDescription</key>
   <string>$(PRODUCT_NAME) speech use</string>

   <!-- 📺 VideoSubscriber -->
   <key>NSVideoSubscriberAccountUsageDescription</key>
   <string>$(PRODUCT_NAME) tvProvider use</string>

如果这样做没起作用，试着去请求后台模式的授权。

<key>UIBackgroundModes</key>
<array>
    <!-- something you should use in background -->
    <string>location</string>
</array>

或者去 target -> Capabilities -> Background Modes -> open the background Modes

enter image description here

然后clean你的工程，run起来。

Reference:

WWDC 2016 Session 709 Engineering Privacy for Your Users Full list of Info.plist keys

你可以在Xib或Storyboard同时使用AutoresizingMask和Autolayout Constraints布局

虽然iOS6已经给出兼容性让开发者同时使用AutoresizingMask和Autolayout Constraints，Xcode会把AutoresizingMask代码转换成Constraints，但是针对Xib或Storyboard却不兼容。

@interface UIView (UIConstraintBasedCompatibility) 

/* By default, the autoresizing mask on a view gives rise to constraints that fully determine 
 the view's position. This allows the auto layout system to track the frames of views whose 
 layout is controlled manually (through -setFrame:, for example).
 When you elect to position the view using auto layout by adding your own constraints, 
 you must set this property to NO. IB will do this for you.
 */
@property(nonatomic) BOOL translatesAutoresizingMaskIntoConstraints NS_AVAILABLE_IOS(6_0); // Default YES
@end

但是现在Xcode可以帮你把AutoresizingMask代码转换成Constraints，所以你可以在Xib或Storyboard中同时使用AutoresizingMask和Autolayout Constraints。

iOS 版本检查

在你的app中不要再使用如下方式检查iOS系统版本

#define IsIOS7 ([[[[UIDevice currentDevice] systemVersion] substringToIndex:1] intValue]>=7)

这会始终返回NO，substringToIndex:1在SDK‘iOS 10.0’(Xcode)中等于SDK‘iOS 1.0’

使用如下的代码替换吧

Objective-C

#define SYSTEM_VERSION_EQUAL_TO(v)                  ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedSame)
#define SYSTEM_VERSION_GREATER_THAN(v)              ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedDescending)
#define SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(v)  ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] != NSOrderedAscending)
#define SYSTEM_VERSION_LESS_THAN(v)                 ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedAscending)
#define SYSTEM_VERSION_LESS_THAN_OR_EQUAL_TO(v)     ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] != NSOrderedDescending)

OR

//App Deployment Target should be beyond 8.0:
if ([[NSProcessInfo processInfo] isOperatingSystemAtLeastVersion:(NSOperatingSystemVersion){.majorVersion = 9, .minorVersion = 1, .patchVersion = 0}]) {
    NSLog(@"Hello from > iOS 9.1");
}

// Using short-form for the struct, we can make things somewhat more compact:
if ([NSProcessInfo.processInfo isOperatingSystemAtLeastVersion:(NSOperatingSystemVersion){9,3,0}]) {
    NSLog(@"Hello from > iOS 9.3");
}

OR

//App Deployment Target should be beyond 2.0:
if (NSFoundationVersionNumber > NSFoundationVersionNumber_iOS_9_0) {
    // do stuff for iOS 9 and newer
} else {
    // do stuff for older versions than iOS 9
}

SDK 'iOS 10.0' (Xcode 8) 给出了更多的版本号码甚至是特征版本(小版本)

#define NSFoundationVersionNumber_iOS_9_0 1240.1
#define NSFoundationVersionNumber_iOS_9_1 1241.14
#define NSFoundationVersionNumber_iOS_9_2 1242.12
#define NSFoundationVersionNumber_iOS_9_3 1242.12
#define NSFoundationVersionNumber_iOS_9_4 1280.25
#define NSFoundationVersionNumber_iOS_9_x_Max 1299

Swift

if NSProcessInfo().isOperatingSystemAtLeastVersion(NSOperatingSystemVersion(majorVersion: 10, minorVersion: 0, patchVersion: 0)) {
    // modern code
}

OR:

if #available(iOS 10.0, *) {
    // modern code
} else {
    // Fallback on earlier versions
}

####iOS10 Dealing With Untrusted Enterprise Developer

自从 iOS9 企业证书发的包没有信任选项了。

用户必须自己处理信任：去设置-通用-profile-进入你的app的profile-点击信任。

但是 iOS10 有一点小的改变。

用户需要去

设置->通用->设备管理->进入你app的profile->点击信任按钮。

Reference:Efficient iOS Version Checking

更多系统对象的 delegate 属性变更，其内存管理语义关键字由 assign 改为了 weak

近年来 iOS-SDK 的 API 设计更加“接地气”，Apple 开始吸取社区中的一些最佳实践：比如尽量避免使用 atomic，delegate 设置为 weak，

iOS9时，Apple 开始将众多系统类的 delegate 和 dataSource 的修饰符从 assign 改为了weak， 其中就包括 UITableView 。

也就是说，在 iOS9之前，我们遇到由于生命周期引起的一些 bug 时，时常的解决方法是在 dealloc 中调用 [systemClassInstance setDelegate:nil] 来释放 delegate。于是在 dealloc 中设置系统对象的 delegate 为 nil，一度成为了“经验”。

在 iOS10 里 Apple 依然在逐步地践行这一系列的最佳实践， iOS10-SDK 中 Apple 重写了很多系统对象的 delegate，将默认的 assign 改为了 weak，比如：UITabBar、UIToolbar 等等，这意味着使用 iOS10-SDK 且采用 Xcode8 编译的项目在 dealloc 中就不必使用 [systemClassInstance setDelegate:nil] 来释放delegate。

各位现在可以到自己项目中，将这些 [systemClassInstance setDelegate:nil] 遗留代码清除掉。

值得注意的是：以上论述皆基于 ARC 项目，MRC项目还是需要将 delegate 手动置 nil。

可以参考 ：

  1. iOS9 API 变动官方文档
  2. iOS10 API 变动官方文档
  3. ARC Enforces New Rules

学习交流群：561873398

相关链接： 《iOS9适配系列教程》 。

About

for iOS10 in [ObjC, Swift, English, 中文] {...}

Resources

Readme

License

MIT license
Activity

Stars

640 stars

Watchers

42 watching

Forks

90 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages