gnome: Added 'executable' method for GTK Android

gnome.executable takes in the same arguments as mesons own executable,
but it automatically builds a shared library on android and links it
with gtk4-android-glue.

docs/markdown/Gnome-module.md

@@ -429,3 +429,11 @@ It takes the following keyword arguments:
   MIME types handled by desktop files in `<prefix>/<datadir>/applications`.
 - `update_mime_database`: *Since 0.64.0* If set to `true`, update cache of
   MIME types in `<prefix>/<datadir>/mime`.
+
+### gnome.executable()
+
+*Since 1.6.0*
+
+Wrapper for executable explicitly targeting applications utilizing GTK. It
+takes the same arguments as
+[executable](Reference-manual_functions.md#executable).

mesonbuild/build.py

@@ -1338,7 +1338,7 @@ def get_pch(self, language: str) -> T.List[str]:
     def get_include_dirs(self) -> T.List['IncludeDirs']:
         return self.include_dirs
 
-    def add_deps(self, deps):
+    def add_deps(self, deps: T.Sequence[dependencies.Dependency]):
         deps = listify(deps)
         for dep in deps:
             if dep in self.added_deps:

mesonbuild/interpreter/interpreter.py

@@ -3357,6 +3357,12 @@ def build_target(self, node: mparser.BaseNode, args: T.Tuple[str, SourcesVarargs
     def build_target(self, node: mparser.BaseNode, args: T.Tuple[str, SourcesVarargsType],
                      kwargs: kwtypes.Jar, targetclass: T.Type[build.Jar]) -> build.Jar: ...
 
+    @T.overload
+    def build_target(self, node: mparser.BaseNode, args: T.Tuple[str, SourcesVarargsType],
+                     kwargs: T.Union[kwtypes.Executable, kwtypes.StaticLibrary, kwtypes.SharedLibrary, kwtypes.SharedModule, kwtypes.Jar],
+                     targetclass: T.Type[T.Union[build.Executable, build.StaticLibrary, build.SharedModule, build.SharedLibrary, build.Jar]]
+                     ) -> T.Union[build.Executable, build.StaticLibrary, build.SharedModule, build.SharedLibrary, build.Jar]: ...
+
     def build_target(self, node: mparser.BaseNode, args: T.Tuple[str, SourcesVarargsType],
                      kwargs: T.Union[kwtypes.Executable, kwtypes.StaticLibrary, kwtypes.SharedLibrary, kwtypes.SharedModule, kwtypes.Jar],
                      targetclass: T.Type[T.Union[build.Executable, build.StaticLibrary, build.SharedModule, build.SharedLibrary, build.Jar]]

mesonbuild/interpreter/kwargs.py

@@ -17,7 +17,9 @@
 from ..options import OptionKey
 from ..modules.cmake import CMakeSubprojectOptions
 from ..programs import ExternalProgram
-from .type_checking import PkgConfigDefineType, SourcesVarargsType
+
+if T.TYPE_CHECKING:
+    from .type_checking import PkgConfigDefineType, SourcesVarargsType
 
 class FuncAddProjectArgs(TypedDict):
 

mesonbuild/modules/__init__.py

@@ -15,8 +15,10 @@
 from ..programs import ExternalProgram
 
 if T.TYPE_CHECKING:
+    from ..interpreter import kwargs as kwtypes
     from ..interpreter import Interpreter
     from ..interpreter.interpreter import ProgramVersionFunc
+    from ..interpreter.type_checking import SourcesVarargsType
     from ..interpreterbase import TYPE_var, TYPE_kwargs
     from ..programs import OverrideProgram
     from ..dependencies import Dependency
@@ -157,6 +159,28 @@ def process_include_dirs(self, dirs: T.Iterable[T.Union[str, IncludeDirs]]) -> T
     def add_language(self, lang: str, for_machine: MachineChoice) -> None:
         self._interpreter.add_languages([lang], True, for_machine)
 
+    @T.overload
+    def add_target(self, args: T.Tuple[str, SourcesVarargsType],
+                   kwargs: kwtypes.Executable, targetclass: T.Type[build.Executable]) -> build.Executable: ...
+
+    @T.overload
+    def add_target(self, args: T.Tuple[str, SourcesVarargsType],
+                   kwargs: kwtypes.StaticLibrary, targetclass: T.Type[build.StaticLibrary]) -> build.StaticLibrary: ...
+
+    @T.overload
+    def add_target(self, args: T.Tuple[str, SourcesVarargsType],
+                   kwargs: kwtypes.SharedModule, targetclass: T.Type[build.SharedModule]) -> build.SharedModule: ...
+
+    @T.overload
+    def add_target(self, args: T.Tuple[str, SourcesVarargsType],
+                   kwargs: kwtypes.SharedLibrary, targetclass: T.Type[build.SharedLibrary]) -> build.SharedLibrary: ...
+
+    def add_target(self, args: T.Tuple[str, SourcesVarargsType],
+                   kwargs: T.Union[kwtypes.Executable, kwtypes.StaticLibrary, kwtypes.SharedLibrary, kwtypes.SharedModule, kwtypes.Jar],
+                   targetclass: T.Type[T.Union[build.Executable, build.StaticLibrary, build.SharedModule, build.SharedLibrary, build.Jar]]
+                   ) -> T.Union[build.Executable, build.StaticLibrary, build.SharedModule, build.SharedLibrary, build.Jar]:
+        return self._interpreter.build_target(self.current_node, args, kwargs, targetclass)
+
 class ModuleObject(HoldableObject):
     """Base class for all objects returned by modules
     """

mesonbuild/modules/gnome.py

@@ -24,8 +24,8 @@
 from ..build import CustomTarget, CustomTargetIndex, Executable, GeneratedList, InvalidArguments
 from ..dependencies import Dependency, InternalDependency
 from ..dependencies.pkgconfig import PkgConfigDependency, PkgConfigInterface
-from ..interpreter.type_checking import DEPENDS_KW, DEPEND_FILES_KW, ENV_KW, INSTALL_DIR_KW, INSTALL_KW, NoneType, DEPENDENCY_SOURCES_KW, in_set_validator
-from ..interpreterbase import noPosargs, noKwargs, FeatureNew, FeatureDeprecated
+from ..interpreter.type_checking import DEPENDS_KW, DEPEND_FILES_KW, ENV_KW, EXECUTABLE_KWS, INSTALL_DIR_KW, INSTALL_KW, SOURCES_VARARGS, NoneType, DEPENDENCY_SOURCES_KW, in_set_validator
+from ..interpreterbase import noPosargs, noKwargs, permittedKwargs, FeatureNew, FeatureDeprecated
 from ..interpreterbase import typed_kwargs, KwargInfo, ContainerTypeInfo
 from ..interpreterbase.decorators import typed_pos_args
 from ..mesonlib import (
@@ -35,13 +35,16 @@
 from ..programs import OverrideProgram
 from ..scripts.gettext import read_linguas
 
+from ..interpreter import kwargs as kwtypes
+
 if T.TYPE_CHECKING:
     from typing_extensions import Literal, TypedDict
 
     from . import ModuleState
     from ..build import BuildTarget
     from ..compilers import Compiler
     from ..interpreter import Interpreter
+    from ..interpreter.type_checking import SourcesVarargsType
     from ..interpreterbase import TYPE_var, TYPE_kwargs
     from ..mesonlib import FileOrString
     from ..programs import ExternalProgram
@@ -274,6 +277,7 @@ def __init__(self, interpreter: 'Interpreter') -> None:
             'mkenums_simple': self.mkenums_simple,
             'genmarshal': self.genmarshal,
             'generate_vapi': self.generate_vapi,
+            'executable': self.executable,
         })
 
     def _get_native_glib_version(self, state: 'ModuleState') -> str:
@@ -2205,6 +2209,22 @@ def generate_vapi(self, state: 'ModuleState', args: T.Tuple[str], kwargs: 'Gener
         created_values.append(rv)
         return ModuleReturnValue(rv, created_values)
 
+    @permittedKwargs(build.known_exe_kwargs)
+    @typed_pos_args('gnome.executable', str, varargs=SOURCES_VARARGS)
+    @typed_kwargs('gnome.executable', *EXECUTABLE_KWS, allow_unknown=True)
+    def executable(self, state: 'ModuleState', args: T.Tuple[str, SourcesVarargsType], kwargs: kwtypes.Executable) -> ModuleReturnValue:
+        target: T.Union[build.Executable, build.SharedModule]
+        if state.environment.machines.host.is_android():
+            kwargs["gui_app"] = None
+            kwargs["win_subsystem"] = None
+
+            target = state.add_target(args, T.cast(kwtypes.SharedModule, kwargs), build.SharedModule)
+            glue = state.dependency('gtk4-android-glue')
+            target.add_deps([glue])
+        else:
+            target = state.add_target(args, kwargs, build.Executable)
+        return ModuleReturnValue(target, [])
+
 def initialize(interp: 'Interpreter') -> GnomeModule:
     mod = GnomeModule(interp)
     mod.interpreter.append_holder_map(GResourceTarget, interpreter.CustomTargetHolder)