platform-specific notes

Author: ndonkoHenri

.github/workflows/build-test.yml

@@ -27,11 +27,11 @@ concurrency:
 env:
   UV_PYTHON: 3.12
   PYTHONUTF8: 1
+  FLET_BUILD_TEMPLATE_REF: 0.80.5
 
   # https://docs.flet.dev/publish/
   BUILD_NUMBER: 1
   BUILD_VERSION: 1.0.0
-  TEMPLATE_REF: 0.81.0
 
   # https://docs.flet.dev/reference/environment-variables
   FLET_CLI_NO_RICH_OUTPUT: 1
@@ -61,7 +61,7 @@ jobs:
 
           - name: windows
             runner: windows-latest
-            build_cmd: "flet build windows --yes --verbose --no-rich-output --build-number=$BUILD_NUMBER --build-version=$BUILD_VERSION"
+            build_cmd: "flet build windows --yes --verbose --build-number=$BUILD_NUMBER --build-version=$BUILD_VERSION"
             artifact_name: windows-build-artifact
             artifact_path: build/windows
             needs_linux_deps: false
@@ -189,7 +189,7 @@ jobs:
         shell: bash
         working-directory: sdk/python/examples/apps/flet_build_test
         run: |
-          uv run ${{ matrix.build_cmd }} --template-ref 0.80.5
+          uv run ${{ matrix.build_cmd }} --template-ref $FLET_BUILD_TEMPLATE_REF
 
       - name: Upload Artifact
         uses: actions/upload-artifact@v5.0.0

sdk/python/packages/flet/docs/datatable2/index.md

@@ -46,7 +46,7 @@ pip install flet-datatable2  # (1)!
 --8<-- "{{ examples }}/example_2.py"
 ```
 
-![DataTable2 example]({{ examples }}/media/example_2.gif)
+{{ image(examples + "/media/example_2.gif", width="80%") }}
 
 ## Description
 

sdk/python/packages/flet/docs/extras/macros/__init__.py

@@ -4,6 +4,7 @@
 
 from .cli_to_md import render_flet_cli_as_markdown
 from .controls_overview import render_nav_overview, render_sub_nav_overview
+from .cross_platform_permissions import cross_platform_permissions_list
 from .pypi_index import render_pypi_index
 
 
@@ -158,3 +159,7 @@ def cookbook_overview():
             base_dir="cookbook",
             skip_paths={"cookbook/index.md"},
         )
+
+    @env.macro
+    def cross_platform_permissions():
+        return cross_platform_permissions_list()

sdk/python/packages/flet/docs/extras/macros/cross_platform_permissions.py

@@ -0,0 +1,93 @@
+import argparse
+
+
+def _indent_block(text: str, indent: int) -> str:
+    prefix = " " * indent
+    return "\n".join(f"{prefix}{line}" for line in text.splitlines())
+
+
+def _toml_key(key: str) -> str:
+    if key.replace("-", "").replace("_", "").isalnum():
+        return key
+    escaped = key.replace("\\", "\\\\").replace('"', '\\"')
+    return f'"{escaped}"'
+
+
+def _toml_value(value) -> str:
+    if isinstance(value, bool):
+        return "true" if value else "false"
+    if value is None:
+        return "null"
+    escaped = str(value).replace("\\", "\\\\").replace('"', '\\"')
+    return f'"{escaped}"'
+
+
+def _load_cross_platform_permissions() -> dict:
+    from flet_cli.commands.build_base import BaseBuildCommand
+
+    parser = argparse.ArgumentParser(add_help=False)
+    command = BaseBuildCommand(parser)
+    return command.cross_platform_permissions
+
+
+def _render_toml_block(config: dict) -> str:
+    info_plist = config.get("info_plist") or {}
+    macos_entitlements = config.get("macos_entitlements") or {}
+    android_permissions = config.get("android_permissions") or {}
+    android_features = config.get("android_features") or {}
+
+    sections = []
+
+    if info_plist:
+        lines = ["# iOS", "[tool.flet.ios.info]"]
+        for key, value in info_plist.items():
+            lines.append(f"{_toml_key(key)} = {_toml_value(value)}")
+        sections.append("\n".join(lines))
+
+        lines = ["# macOS", "[tool.flet.macos.info]"]
+        for key, value in info_plist.items():
+            lines.append(f"{_toml_key(key)} = {_toml_value(value)}")
+        if macos_entitlements:
+            lines.extend(["", "[tool.flet.macos.entitlement]"])
+            for key, value in macos_entitlements.items():
+                lines.append(f"{_toml_key(key)} = {_toml_value(value)}")
+        sections.append("\n".join(lines))
+
+    if android_permissions:
+        lines = ["# Android", "[tool.flet.android.permission]"]
+        for key, value in android_permissions.items():
+            lines.append(f"{_toml_key(key)} = {_toml_value(value)}")
+        if android_features:
+            lines.extend(["", "[tool.flet.android.feature]"])
+            for key, value in android_features.items():
+                lines.append(f"{_toml_key(key)} = {_toml_value(value)}")
+        sections.append("\n".join(lines))
+
+    return "\n\n".join(sections)
+
+
+def cross_platform_permissions_list() -> str:
+    permissions = _load_cross_platform_permissions()
+    items = []
+    for name, config in permissions.items():
+        toml_block = _indent_block(_render_toml_block(config), 4)
+        items.append(
+            "\n".join(
+                [
+                    f"- `{name}`",
+                    "",
+                    "    /// details | `pyproject.toml` equivalent",
+                    "        type: example",
+                    "    ```toml",
+                    toml_block,
+                    "    ```",
+                    "    ///",
+                ]
+            )
+        )
+
+    return "\n\n".join(items) + "\n"
+
+
+if __name__ == "__main__":
+    print(cross_platform_permissions_list())

sdk/python/packages/flet/docs/publish/android.md

@@ -169,7 +169,7 @@ If not, create one using one of the following methods:
     ```
     You will be prompted for several details, such as a keystore password,
     a key alias, your names, and location. Remember the password and alias
-    for use in the [configuration](#configuration) step below.
+    for use in the configuration steps below.
 
     A file named `upload-keystore.jks` will be created in your home directory.
     If you want to store it elsewhere, change the argument passed to the `-keystore` parameter.