feat(android): add hint text parameters to CardFormField (#2296)

* feat(android): add hint text parameters to CardFormField

Add numberHintText, expirationHintText, cvcHintText, and postalCodeHintText
parameters to CardFormField widget for consistency with CardField.

These parameters allow customizing placeholder text for card input fields.
Note: This feature is Android-only as iOS's STPCardFormView does not
support placeholder customization.

Fixes #2277

* Regenerate code after giropay removal

* ci: add server readiness check before integration tests

---------

Co-authored-by: jonasbark <jonas.bark@gmx.de>

Author: meylis1998

.github/workflows/all_plugins.yaml

@@ -108,6 +108,18 @@ jobs:
       working-directory: example/server
       run: yarn install && (yarn start:dev &)
 
+    - name: "Wait for server to be ready"
+      run: |
+        echo "Waiting for server to start..."
+        for i in {1..30}; do
+          if curl -s http://localhost:4242 > /dev/null 2>&1; then
+            echo "Server is ready!"
+            break
+          fi
+          echo "Attempt $i: Server not ready yet, waiting..."
+          sleep 2
+        done
+
     - name: "Set IP address"
       working-directory: example
       run: |
@@ -161,6 +173,18 @@ jobs:
       working-directory: example/server
       run: yarn install && (yarn start:dev &)
 
+    - name: "Wait for server to be ready"
+      run: |
+        echo "Waiting for server to start..."
+        for i in {1..30}; do
+          if curl -s http://localhost:4242 > /dev/null 2>&1; then
+            echo "Server is ready!"
+            break
+          fi
+          echo "Attempt $i: Server not ready yet, waiting..."
+          sleep 2
+        done
+
     - name: "Set IP address"
       working-directory: example
       run: |
@@ -172,9 +196,12 @@ jobs:
       with:
         api-level: 34
         arch: x86_64
-        emulator-boot-timeout: 1400
+        emulator-boot-timeout: 1800
+        force-avd-creation: false
+        emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim
+        disable-animations: true
         working-directory: example
-        script: | 
+        script: |
           sleep 15;
           flutter drive --driver test_driver/integration_test.dart --target=integration_test/run_all_tests.dart;
           cd android && ./gradlew :app:connectedDebugAndroidTest;

packages/stripe/lib/src/widgets/card_form_field.dart

@@ -30,6 +30,10 @@ class CardFormField extends StatefulWidget {
     this.disabled = false,
     this.controller,
     this.preferredNetworks,
+    this.numberHintText,
+    this.expirationHintText,
+    this.cvcHintText,
+    this.postalCodeHintText,
     super.key,
   });
 
@@ -93,6 +97,18 @@ class CardFormField extends StatefulWidget {
   /// This value will only be used if your user hasn't selected a network themselves.
   final List<CardBrand>? preferredNetworks;
 
+  /// Android only: Hint text for the card number field.
+  final String? numberHintText;
+
+  /// Android only: Hint text for the expiration date field.
+  final String? expirationHintText;
+
+  /// Android only: Hint text for the cvc field.
+  final String? cvcHintText;
+
+  /// Android only: Hint text for the postal code field.
+  final String? postalCodeHintText;
+
   @override
   // ignore: library_private_types_in_public_api
   _CardFormFieldState createState() => _CardFormFieldState();
@@ -207,6 +223,10 @@ class _CardFormFieldState extends State<CardFormField> {
       onFocus: widget.onFocus,
       countryCode: widget.countryCode,
       preferredNetworks: widget.preferredNetworks,
+      numberHintText: widget.numberHintText,
+      expirationHintText: widget.expirationHintText,
+      cvcHintText: widget.cvcHintText,
+      postalCodeHintText: widget.postalCodeHintText,
     );
   }
 
@@ -232,6 +252,10 @@ class _MethodChannelCardFormField extends StatefulWidget {
     this.disabled = false,
     this.preferredNetworks,
     this.countryCode,
+    this.numberHintText,
+    this.expirationHintText,
+    this.cvcHintText,
+    this.postalCodeHintText,
   }) : assert(constraints == null || constraints.debugAssertIsValid()),
        constraints = (width != null || height != null)
            ? constraints?.tighten(width: width, height: height) ??
@@ -251,6 +275,10 @@ class _MethodChannelCardFormField extends StatefulWidget {
   final bool dangerouslyUpdateFullCardDetails;
   final String? countryCode;
   final List<CardBrand>? preferredNetworks;
+  final String? numberHintText;
+  final String? expirationHintText;
+  final String? cvcHintText;
+  final String? postalCodeHintText;
 
   // This is used in the platform side to register the view.
   static const _viewType = 'flutter.stripe/card_form_field';
@@ -312,6 +340,14 @@ class _MethodChannelCardFormFieldState
   Widget build(BuildContext context) {
     final style = resolveStyle(widget.style);
     // Pass parameters to the platform side.
+    // Build placeholder map for hint text (Android only)
+    final placeholder = <String, dynamic>{
+      if (widget.numberHintText != null) 'number': widget.numberHintText,
+      if (widget.expirationHintText != null) 'expiration': widget.expirationHintText,
+      if (widget.cvcHintText != null) 'cvc': widget.cvcHintText,
+      if (widget.postalCodeHintText != null) 'postalCode': widget.postalCodeHintText,
+    };
+
     final creationParams = <String, dynamic>{
       'cardStyle': style.toJson(),
       'postalCodeEnabled': widget.enablePostalCode,
@@ -326,6 +362,7 @@ class _MethodChannelCardFormFieldState
             .toList(),
       'disabled': widget.disabled,
       'defaultValues': {'countryCode': widget.countryCode},
+      if (placeholder.isNotEmpty) 'placeholders': placeholder,
     };
 
     Widget platform;
@@ -433,6 +470,20 @@ class _MethodChannelCardFormFieldState
       });
     }
     _lastStyle = style;
+    // Handle placeholder/hint text changes (Android only)
+    if (widget.numberHintText != oldWidget.numberHintText ||
+        widget.expirationHintText != oldWidget.expirationHintText ||
+        widget.cvcHintText != oldWidget.cvcHintText ||
+        widget.postalCodeHintText != oldWidget.postalCodeHintText) {
+      final placeholder = <String, dynamic>{
+        if (widget.numberHintText != null) 'number': widget.numberHintText,
+        if (widget.expirationHintText != null) 'expiration': widget.expirationHintText,
+        if (widget.cvcHintText != null) 'cvc': widget.cvcHintText,
+        if (widget.postalCodeHintText != null) 'postalCode': widget.postalCodeHintText,
+      };
+      // Use 'placeholders' as method name - Android delegate uses it as property name
+      _methodChannel?.invokeMethod('placeholders', placeholder);
+    }
     super.didUpdateWidget(oldWidget);
   }