[quick_actions] add localizedSubtitle for iOS

packages/quick_actions/quick_actions/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.0.9
+
+* Adds localizedSubtitle field for iOS quick actions.
+
 ## 1.0.8
 
 * Updates minimum supported SDK version to Flutter 3.19/Dart 3.3.

packages/quick_actions/quick_actions/README.md

@@ -34,7 +34,7 @@ Finally, manage the app's quick actions, for instance:
 ```dart
 quickActions.setShortcutItems(<ShortcutItem>[
   const ShortcutItem(type: 'action_main', localizedTitle: 'Main view', icon: 'icon_main'),
-  const ShortcutItem(type: 'action_help', localizedTitle: 'Help', icon: 'icon_help')
+  const ShortcutItem(type: 'action_help', localizedTitle: 'Help', localizedSubtitle: 'Tap to get help', icon: 'icon_help')
 ]);
 ```
 

packages/quick_actions/quick_actions/example/lib/main.dart

@@ -53,14 +53,16 @@ class _MyHomePageState extends State<MyHomePage> {
       const ShortcutItem(
         type: 'action_one',
         localizedTitle: 'Action one',
+        localizedSubtitle: 'Action one subtitle',
         icon: 'AppIcon',
       ),
       // NOTE: This second action icon will only work on Android.
       // In a real world project keep the same file name for both platforms.
       const ShortcutItem(
-          type: 'action_two',
-          localizedTitle: 'Action two',
-          icon: 'ic_launcher'),
+        type: 'action_two',
+        localizedTitle: 'Action two',
+        icon: 'ic_launcher',
+      ),
     ]).then((void _) {
       setState(() {
         if (shortcut == 'no action set') {

packages/quick_actions/quick_actions/pubspec.yaml

@@ -3,7 +3,7 @@ description: Flutter plugin for creating shortcuts on home screen, also known as
   Quick Actions on iOS and App Shortcuts on Android.
 repository: https://github.com/flutter/packages/tree/main/packages/quick_actions/quick_actions
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+quick_actions%22
-version: 1.0.8
+version: 1.0.9
 
 environment:
   sdk: ^3.3.0
@@ -22,7 +22,7 @@ dependencies:
     sdk: flutter
   quick_actions_android: ^1.0.0
   quick_actions_ios: ^1.0.0
-  quick_actions_platform_interface: ^1.0.0
+  quick_actions_platform_interface: ^1.1.0
 
 dev_dependencies:
   flutter_test:

packages/quick_actions/quick_actions_ios/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 1.1.2
 
+* Adds localizedSubtitle field for iOS quick actions.
 * Updates minimum supported SDK version to Flutter 3.19/Dart 3.3.
 
 ## 1.1.1

packages/quick_actions/quick_actions_ios/example/ios/RunnerUITests/RunnerUITests.swift

@@ -75,7 +75,8 @@ class RunnerUITests: XCTestCase {
     }
 
     findAndTapQuickActionButton(
-      buttonName: "Action one", quickActionsAppIcon: quickActionsAppIcon, springboard: springboard)
+      buttonName: "Action one, Action one subtitle", quickActionsAppIcon: quickActionsAppIcon,
+      springboard: springboard)
 
     let actionOneConfirmation = exampleApp.otherElements["action_one"]
     if !actionOneConfirmation.waitForExistence(timeout: elementWaitingTime) {

packages/quick_actions/quick_actions_ios/example/lib/main.dart

@@ -51,6 +51,7 @@ class _MyHomePageState extends State<MyHomePage> {
       const ShortcutItem(
         type: 'action_one',
         localizedTitle: 'Action one',
+        localizedSubtitle: 'Action one subtitle',
         icon: 'AppIcon',
       ),
       const ShortcutItem(

packages/quick_actions/quick_actions_ios/ios/quick_actions_ios/Sources/quick_actions_ios/QuickActionsPlugin.swift

@@ -90,18 +90,15 @@ public final class QuickActionsPlugin: NSObject, FlutterPlugin, IOSQuickActionsA
     -> UIApplicationShortcutItem?
   {
 
-    let type = shortcut.type
-    let localizedTitle = shortcut.localizedTitle
-
     let icon = (shortcut.icon).map {
       UIApplicationShortcutIcon(templateImageName: $0)
     }
 
     // type and localizedTitle are required.
     return UIApplicationShortcutItem(
-      type: type,
-      localizedTitle: localizedTitle,
-      localizedSubtitle: nil,
+      type: shortcut.type,
+      localizedTitle: shortcut.localizedTitle,
+      localizedSubtitle: shortcut.localizedSubtitle,
       icon: icon,
       userInfo: nil)
   }

packages/quick_actions/quick_actions_ios/ios/quick_actions_ios/Sources/quick_actions_ios/messages.g.swift

@@ -81,29 +81,35 @@ struct ShortcutItemMessage {
   var type: String
   /// Localized title of the item.
   var localizedTitle: String
+  /// Localized subtitle of the item.
+  var localizedSubtitle: String? = nil
   /// Name of native resource to be displayed as the icon for this item.
   var icon: String? = nil
 
   // swift-format-ignore: AlwaysUseLowerCamelCase
   static func fromList(_ __pigeon_list: [Any?]) -> ShortcutItemMessage? {
     let type = __pigeon_list[0] as! String
     let localizedTitle = __pigeon_list[1] as! String
-    let icon: String? = nilOrValue(__pigeon_list[2])
+    let localizedSubtitle: String? = nilOrValue(__pigeon_list[2])
+    let icon: String? = nilOrValue(__pigeon_list[3])
 
     return ShortcutItemMessage(
       type: type,
       localizedTitle: localizedTitle,
+      localizedSubtitle: localizedSubtitle,
       icon: icon
     )
   }
   func toList() -> [Any?] {
     return [
       type,
       localizedTitle,
+      localizedSubtitle,
       icon,
     ]
   }
 }
+
 private class messagesPigeonCodecReader: FlutterStandardReader {
   override func readValue(ofType type: UInt8) -> Any? {
     switch type {
@@ -195,12 +201,14 @@ class IOSQuickActionsApiSetup {
     }
   }
 }
+
 /// Generated protocol from Pigeon that represents Flutter messages that can be called from Swift.
 protocol IOSQuickActionsFlutterApiProtocol {
   /// Sends a string representing a shortcut from the native platform to the app.
   func launchAction(
     action actionArg: String, completion: @escaping (Result<Void, PigeonError>) -> Void)
 }
+
 class IOSQuickActionsFlutterApi: IOSQuickActionsFlutterApiProtocol {
   private let binaryMessenger: FlutterBinaryMessenger
   private let messageChannelSuffix: String

packages/quick_actions/quick_actions_ios/lib/messages.g.dart

@@ -34,6 +34,7 @@ class ShortcutItemMessage {
   ShortcutItemMessage({
     required this.type,
     required this.localizedTitle,
+    this.localizedSubtitle,
     this.icon,
   });
 
@@ -43,13 +44,17 @@ class ShortcutItemMessage {
   /// Localized title of the item.
   String localizedTitle;
 
+  /// Localized subtitle of the item.
+  String? localizedSubtitle;
+
   /// Name of native resource to be displayed as the icon for this item.
   String? icon;
 
   Object encode() {
     return <Object?>[
       type,
       localizedTitle,
+      localizedSubtitle,
       icon,
     ];
   }
@@ -59,7 +64,8 @@ class ShortcutItemMessage {
     return ShortcutItemMessage(
       type: result[0]! as String,
       localizedTitle: result[1]! as String,
-      icon: result[2] as String?,
+      localizedSubtitle: result[2] as String?,
+      icon: result[3] as String?,
     );
   }
 }

packages/quick_actions/quick_actions_ios/lib/quick_actions_ios.dart

@@ -47,6 +47,7 @@ class QuickActionsIos extends QuickActionsPlatform {
     return ShortcutItemMessage(
       type: item.type,
       localizedTitle: item.localizedTitle,
+      localizedSubtitle: item.localizedSubtitle,
       icon: item.icon,
     );
   }

packages/quick_actions/quick_actions_ios/pigeons/messages.dart

@@ -15,6 +15,7 @@ class ShortcutItemMessage {
   ShortcutItemMessage(
     this.type,
     this.localizedTitle,
+    this.localizedSubtitle,
     this.icon,
   );
 
@@ -24,6 +25,9 @@ class ShortcutItemMessage {
   /// Localized title of the item.
   String localizedTitle;
 
+  /// Localized subtitle of the item.
+  String? localizedSubtitle;
+
   /// Name of native resource to be displayed as the icon for this item.
   String? icon;
 }

packages/quick_actions/quick_actions_ios/pubspec.yaml

@@ -2,7 +2,7 @@ name: quick_actions_ios
 description: An implementation for the iOS platform of the Flutter `quick_actions` plugin.
 repository: https://github.com/flutter/packages/tree/main/packages/quick_actions/quick_actions_ios
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+in_app_purchase%22
-version: 1.1.1
+version: 1.1.2
 
 environment:
   sdk: ^3.3.0
@@ -19,7 +19,7 @@ flutter:
 dependencies:
   flutter:
     sdk: flutter
-  quick_actions_platform_interface: ^1.0.0
+  quick_actions_platform_interface: ^1.1.0
 
 dev_dependencies:
   flutter_test:

packages/quick_actions/quick_actions_ios/test/quick_actions_ios_test.dart

@@ -26,19 +26,28 @@ void main() {
 
   test('setShortcutItems', () async {
     await quickActions.initialize((String type) {});
-    const ShortcutItem item =
-        ShortcutItem(type: 'test', localizedTitle: 'title', icon: 'icon.svg');
+    const ShortcutItem item = ShortcutItem(
+      type: 'test',
+      localizedTitle: 'title',
+      localizedSubtitle: 'subtitle',
+      icon: 'icon.svg',
+    );
     await quickActions.setShortcutItems(<ShortcutItem>[item]);
 
     expect(api.items.first.type, item.type);
     expect(api.items.first.localizedTitle, item.localizedTitle);
+    expect(api.items.first.localizedSubtitle, item.localizedSubtitle);
     expect(api.items.first.icon, item.icon);
   });
 
   test('clearShortCutItems', () {
     quickActions.initialize((String type) {});
-    const ShortcutItem item =
-        ShortcutItem(type: 'test', localizedTitle: 'title', icon: 'icon.svg');
+    const ShortcutItem item = ShortcutItem(
+      type: 'test',
+      localizedTitle: 'title',
+      localizedSubtitle: 'subtitle',
+      icon: 'icon.svg',
+    );
     quickActions.setShortcutItems(<ShortcutItem>[item]);
     quickActions.clearShortcutItems();
 
@@ -48,13 +57,19 @@ void main() {
   test('Shortcut item can be constructed', () {
     const String type = 'type';
     const String localizedTitle = 'title';
+    const String localizedSubtitle = 'subtitle';
     const String icon = 'foo';
 
-    const ShortcutItem item =
-        ShortcutItem(type: type, localizedTitle: localizedTitle, icon: icon);
+    const ShortcutItem item = ShortcutItem(
+      type: type,
+      localizedTitle: localizedTitle,
+      localizedSubtitle: localizedSubtitle,
+      icon: icon,
+    );
 
     expect(item.type, type);
     expect(item.localizedTitle, localizedTitle);
+    expect(item.localizedSubtitle, localizedSubtitle);
     expect(item.icon, icon);
   });
 }
@@ -83,6 +98,7 @@ ShortcutItem shortcutItemMessageToShortcutItem(ShortcutItemMessage item) {
   return ShortcutItem(
     type: item.type,
     localizedTitle: item.localizedTitle,
+    localizedSubtitle: item.localizedSubtitle,
     icon: item.icon,
   );
 }