Add launch_at_login example and bindgen tweaks

Add a new Flutter example (examples/launch_at_login_example) demonstrating the LaunchAtLogin API with macOS project files, README, and a complete example UI. Update bindgen configuration to emit generated Dart into packages/nativeapi/lib/src, add string param setup/cleanup and param_name mapping, and adjust the dart-format target. Modify bindgen templates to: import and use cnativeApiBindings for global functions, special-case LaunchAtLogin constructors, marshal program/arguments arrays and returned string lists, and handle string params/returns correctly. Also update nativeapi package sources and cnativeapi bindings/stubs to align with the generated API and update pubspec accordingly.

Author: lijy91

bindgen/README.md

@@ -13,8 +13,7 @@ cd nativeapi-flutter
 PYTHONPATH=packages/cnativeapi/cxx_impl/tools python3 -m bindgen \
   --config bindgen/config.yaml \
   --dump-ir bindgen/out/ir.json \
-  --dump-context bindgen/out/context.json \
-  --out bindgen/out
+  --dump-context bindgen/out/context.json
 ```
 
 ## Notes

bindgen/config.yaml

@@ -1,9 +1,12 @@
+output_dir: packages/nativeapi/lib/src
+
 clang_flags:
   - -x
   - c++
   - -std=c++17
 
 entry_headers:
+  - packages/cnativeapi/cxx_impl/src/launch_at_login.h
   - packages/cnativeapi/cxx_impl/src/url_opener.h
 
 mapping:
@@ -14,6 +17,7 @@ mapping:
     enum_value_name: camel_case
     method_name: camel_case
     field_name: camel_case
+    param_name: camel_case
 
   types:
     void: void
@@ -34,10 +38,12 @@ mapping:
   options:
     singleton_classes:
       - UrlOpener
+    string_param_setup: "final {native_name} = {name}.toNativeUtf8().cast<ffi.Char>();"
+    string_param_cleanup: "pkgffi.malloc.free({native_name});"
     formatters:
       - name: dart-format-generated
         cmd:
           - dart
           - format
-          - "{out_dir}/src"
+          - "{out_dir}"
         continue_on_error: true

bindgen/template/file/dart.j2

@@ -4,6 +4,14 @@
 {%- from 'partials/class.j2' import render_class -%}
 {%- from 'partials/constant.j2' import render_constant -%}
 {%- from 'partials/alias.j2' import render_alias -%}
+{%- set import_state = namespace(needs_global_bindings=has_functions) -%}
+{%- for item in classes -%}
+{%- for method in item.methods -%}
+{%- if method.static and not method.skip -%}
+{%- set import_state.needs_global_bindings = true -%}
+{%- endif -%}
+{%- endfor -%}
+{%- endfor -%}
 
 // =============================================================================
 // Auto-generated Dart wrapper for: {{ file_path }}
@@ -19,6 +27,9 @@ import 'dart:ui' as ui;
 {%- if uses_pkgffi %}
 import 'package:ffi/ffi.dart' as pkgffi;
 {%- endif %}
+{%- if import_state.needs_global_bindings %}
+import 'package:cnativeapi/cnativeapi.dart' show cnativeApiBindings;
+{%- endif %}
 import 'package:nativeapi/src/foundation/cnativeapi_bindings_mixin.dart';
 {%- if has_handle_classes %}
 import 'package:nativeapi/src/foundation/native_handle_wrapper.dart';

bindgen/template/partials/class.j2

@@ -1,5 +1,5 @@
 {%- macro render_method_call(method) -%}
-bindings.{{ method.call_symbol }}(
+{{ 'cnativeApiBindings' if method.static else 'bindings' }}.{{ method.call_symbol }}(
 {%- if method.needs_instance_handle %}
   _nativeHandle{% if method.call_args|length > 0 %}, {% endif %}
 {%- endif %}
@@ -9,8 +9,86 @@ bindings.{{ method.call_symbol }}(
 )
 {%- endmacro -%}
 
+{%- macro render_method_return_type(method) -%}
+{%- if method.call_symbol.endswith('_get_arguments') and method.return_bridge == 'string' -%}
+List<String>
+{%- else -%}
+{{ method.api_return_type }}
+{%- endif -%}
+{%- endmacro -%}
+
+{%- macro render_method_param(method, param) -%}
+{%- if method.call_symbol.endswith('_set_program') and param.name == 'arguments' and param.api_type == 'String' -%}
+List<String> {{ param.name }}
+{%- else -%}
+{{ param.api_type }} {{ param.name }}
+{%- endif -%}
+{%- endmacro -%}
+
 {%- macro render_method_body(method) -%}
-{%- if method.return_bridge == 'string' %}
+{%- if method.call_symbol.endswith('_get_arguments') and method.return_bridge == 'string' %}
+    final outArguments = pkgffi.malloc<ffi.Pointer<ffi.Pointer<ffi.Char>>>();
+    final outCount = pkgffi.malloc<ffi.Size>();
+    try {
+      final success = bindings.{{ method.call_symbol }}(
+        _nativeHandle,
+        outArguments,
+        outCount,
+      );
+      if (!success || outArguments.value == ffi.nullptr) {
+        return <String>[];
+      }
+
+      final count = outCount.value;
+      final nativeArguments = outArguments.value;
+      final result = <String>[];
+      for (var i = 0; i < count; i++) {
+        final nativeArgument = nativeArguments[i];
+        result.add(
+          nativeArgument == ffi.nullptr
+              ? ''
+              : nativeArgument.cast<pkgffi.Utf8>().toDartString(),
+        );
+      }
+
+      for (var i = 0; i < count; i++) {
+        final nativeArgument = nativeArguments[i];
+        if (nativeArgument != ffi.nullptr) {
+          bindings.free_c_str(nativeArgument);
+        }
+      }
+      pkgffi.malloc.free(nativeArguments);
+      return result;
+    } finally {
+      pkgffi.malloc.free(outCount);
+      pkgffi.malloc.free(outArguments);
+    }
+{%- elif method.call_symbol.endswith('_set_program') and method.params|length == 2 %}
+    final executablePathNative =
+        executablePath.toNativeUtf8().cast<ffi.Char>();
+    final argumentsNative = arguments.isEmpty
+        ? ffi.nullptr.cast<ffi.Pointer<ffi.Char>>()
+        : pkgffi.malloc<ffi.Pointer<ffi.Char>>(arguments.length);
+    try {
+      for (var i = 0; i < arguments.length; i++) {
+        argumentsNative[i] = arguments[i].toNativeUtf8().cast<ffi.Char>();
+      }
+      return bindings.{{ method.call_symbol }}(
+        _nativeHandle,
+        executablePathNative,
+        argumentsNative,
+        arguments.length,
+      );
+    } finally {
+      for (var i = 0; i < arguments.length; i++) {
+        pkgffi.malloc.free(argumentsNative[i]);
+      }
+      if (arguments.isNotEmpty) {
+        pkgffi.malloc.free(argumentsNative);
+      }
+      pkgffi.malloc.free(executablePathNative);
+    }
+{%- elif method.return_bridge == 'string' %}
     final cString = {{ render_method_call(method) }};
     if (cString == ffi.nullptr) return '';
     final value = cString.cast<pkgffi.Utf8>().toDartString();
@@ -50,6 +128,11 @@ bindings.{{ method.call_symbol }}(
 {%- endmacro -%}
 
 {%- macro render_callable(method) -%}
+{%- if method.call_symbol.endswith('_get_arguments') and method.return_bridge == 'string' %}
+{{ render_method_body(method) }}
+{%- elif method.call_symbol.endswith('_set_program') and method.params|length == 2 %}
+{{ render_method_body(method) }}
+{%- else %}
 {%- for line in method.pre_call_lines %}
     {{ line }}
 {%- endfor %}
@@ -64,6 +147,7 @@ bindings.{{ method.call_symbol }}(
 {%- else %}
 {{ render_method_body(method) }}
 {%- endif %}
+{%- endif %}
 {%- endmacro -%}
 
 {%- macro render_class(item, mapping) -%}
@@ -76,13 +160,13 @@ class {{ item.name }} with CNativeApiBindingsMixin {
 {%- for method in item.methods %}
 {%- if not method.skip %}
   {%- if method.is_property %}
-  {{ 'static ' if method.static else '' }}{{ method.api_return_type }} get {{ method.property_name }} {
+  {{ 'static ' if method.static else '' }}{{ render_method_return_type(method) }} get {{ method.property_name }} {
 {{ render_callable(method) }}
   }
   {%- else %}
-  {{ 'static ' if method.static else '' }}{{ method.api_return_type }} {{ method.api_name }}(
+  {{ 'static ' if method.static else '' }}{{ render_method_return_type(method) }} {{ method.api_name }}(
   {%- for param in method.params %}
-    {{ param.api_type }} {{ param.name }}{% if not loop.last %}, {% endif %}
+    {{ render_method_param(method, param) }}{% if not loop.last %}, {% endif %}
   {%- endfor %}
   ) {
 {{ render_callable(method) }}
@@ -106,25 +190,65 @@ class {{ item.name }} with CNativeApiBindingsMixin implements NativeHandleWrappe
   late final {{ item.handle_alias }} _nativeHandle;
   final bool _ownsHandle;
 
+  {%- if item.name == 'LaunchAtLogin' %}
+  {{ item.name }}({
+    String? id,
+    String? displayName,
+    {{ item.handle_alias }}? nativeHandle,
+  }) : _ownsHandle = nativeHandle == null {
+    if (nativeHandle != null) {
+      _nativeHandle = nativeHandle;
+      return;
+    }
+
+    if (id != null && displayName != null) {
+      final idNative = id.toNativeUtf8().cast<ffi.Char>();
+      final displayNameNative = displayName.toNativeUtf8().cast<ffi.Char>();
+      try {
+        _nativeHandle = bindings.{{ item.create_symbol }}_with_id_and_name(
+          idNative,
+          displayNameNative,
+        );
+      } finally {
+        pkgffi.malloc.free(displayNameNative);
+        pkgffi.malloc.free(idNative);
+      }
+      return;
+    }
+
+    if (id != null) {
+      final idNative = id.toNativeUtf8().cast<ffi.Char>();
+      try {
+        _nativeHandle = bindings.{{ item.create_symbol }}_with_id(idNative);
+      } finally {
+        pkgffi.malloc.free(idNative);
+      }
+      return;
+    }
+
+    _nativeHandle = bindings.{{ item.create_symbol }}();
+  }
+  {%- else %}
   {{ item.name }}([{{ item.handle_alias }}? nativeHandle])
       : _ownsHandle = nativeHandle == null {
     _nativeHandle = nativeHandle ?? bindings.{{ item.create_symbol }}();
   }
   {%- endif %}
+  {%- endif %}
 
   @override
   {{ item.handle_alias }} get nativeHandle => _nativeHandle;
 
 {%- for method in item.methods %}
 {%- if not method.skip %}
   {%- if method.is_property %}
-  {{ 'static ' if method.static else '' }}{{ method.api_return_type }} get {{ method.property_name }} {
+  {{ 'static ' if method.static else '' }}{{ render_method_return_type(method) }} get {{ method.property_name }} {
 {{ render_callable(method) }}
   }
   {%- else %}
-  {{ 'static ' if method.static else '' }}{{ method.api_return_type }} {{ method.api_name }}(
+  {{ 'static ' if method.static else '' }}{{ render_method_return_type(method) }} {{ method.api_name }}(
   {%- for param in method.params %}
-    {{ param.api_type }} {{ param.name }}{% if not loop.last %}, {% endif %}
+    {{ render_method_param(method, param) }}{% if not loop.last %}, {% endif %}
   {%- endfor %}
   ) {
 {{ render_callable(method) }}

bindgen/template/partials/function.j2

@@ -1,5 +1,5 @@
 {%- macro render_function_call(item) -%}
-bindings.{{ item.call_symbol }}(
+cnativeApiBindings.{{ item.call_symbol }}(
 {%- for arg in item.call_args %}
   {{ arg }}{% if not loop.last %}, {% endif %}
 {%- endfor %}

examples/launch_at_login_example/.gitignore

@@ -0,0 +1,45 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.build/
+.buildlog/
+.history
+.svn/
+.swiftpm/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+/build/
+/coverage/
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release

examples/launch_at_login_example/.metadata

@@ -0,0 +1,30 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "645a4e5fe50892fa3058d1e52bd405717bd00b74"
+  channel: "main"
+
+project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: 645a4e5fe50892fa3058d1e52bd405717bd00b74
+      base_revision: 645a4e5fe50892fa3058d1e52bd405717bd00b74
+    - platform: macos
+      create_revision: 645a4e5fe50892fa3058d1e52bd405717bd00b74
+      base_revision: 645a4e5fe50892fa3058d1e52bd405717bd00b74
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

examples/launch_at_login_example/README.md

@@ -0,0 +1,10 @@
+# launch_at_login_example
+
+Flutter example demonstrating how to use the `LaunchAtLogin` API from `package:nativeapi`.
+
+This example shows how to:
+
+- Check if launch-at-login is supported on the current platform.
+- Create and configure a launch-at-login entry (display name, program, arguments).
+- Enable and disable launch-at-login for your application.
+- Read back the current launch-at-login state and configuration.

examples/launch_at_login_example/analysis_options.yaml

@@ -0,0 +1,4 @@
+include: package:flutter_lints/flutter.yaml
+
+linter:
+  rules: