[FL-2627] Flipper applications: SDK, build and debug system (#1387)

* Added support for running applications from SD card (FAPs - Flipper Application Packages)
* Added plugin_dist target for fbt to build FAPs
* All apps of type FlipperAppType.EXTERNAL and FlipperAppType.PLUGIN are built as FAPs by default
* Updated VSCode configuration for new fbt features - re-deploy stock configuration to use them
* Added debugging support for FAPs with fbt debug & VSCode
* Added public firmware API with automated versioning

Co-authored-by: hedger <hedger@users.noreply.github.com>
Co-authored-by: SG <who.just.the.doctor@gmail.com>
Co-authored-by: あく <alleteam@gmail.com>

scripts/assets.py

@@ -3,16 +3,12 @@
 from flipper.app import App
 from flipper.assets.icon import file2image
 
-import logging
-import argparse
-import subprocess
-import io
 import os
-import sys
 
 ICONS_SUPPORTED_FORMATS = ["png"]
 
 ICONS_TEMPLATE_H_HEADER = """#pragma once
+
 #include <gui/icon.h>
 
 """

scripts/runfap.py

@@ -0,0 +1,99 @@
+#!/usr/bin/env python3
+
+import posixpath
+from typing import final
+from flipper.app import App
+from flipper.storage import FlipperStorage
+from flipper.utils.cdc import resolve_port
+
+import logging
+import os
+import pathlib
+import serial.tools.list_ports as list_ports
+
+
+class Main(App):
+    def init(self):
+        self.parser.add_argument("-p", "--port", help="CDC Port", default="auto")
+
+        self.parser.add_argument("fap_src_path", help="App file to upload")
+        self.parser.add_argument(
+            "--fap_dst_dir", help="Upload path", default="/ext/apps", required=False
+        )
+        self.parser.set_defaults(func=self.install)
+
+        # logging
+        self.logger = logging.getLogger()
+
+    # make directory with exist check
+    def mkdir_on_storage(self, storage, flipper_dir_path):
+        if not storage.exist_dir(flipper_dir_path):
+            self.logger.debug(f'"{flipper_dir_path}" does not exist, creating')
+            if not storage.mkdir(flipper_dir_path):
+                self.logger.error(f"Error: {storage.last_error}")
+                return False
+        else:
+            self.logger.debug(f'"{flipper_dir_path}" already exists')
+        return True
+
+    # send file with exist check and hash check
+    def send_file_to_storage(self, storage, flipper_file_path, local_file_path, force):
+        exists = storage.exist_file(flipper_file_path)
+        do_upload = not exists
+        if exists:
+            hash_local = storage.hash_local(local_file_path)
+            hash_flipper = storage.hash_flipper(flipper_file_path)
+            self.logger.debug(f"hash check: local {hash_local}, flipper {hash_flipper}")
+            do_upload = force or (hash_local != hash_flipper)
+
+        if do_upload:
+            self.logger.info(f'Sending "{local_file_path}" to "{flipper_file_path}"')
+            if not storage.send_file(local_file_path, flipper_file_path):
+                self.logger.error(f"Error: {storage.last_error}")
+                return False
+        return True
+
+    def install(self):
+        if not (port := resolve_port(self.logger, self.args.port)):
+            return 1
+
+        storage = FlipperStorage(port)
+        storage.start()
+
+        try:
+            fap_local_path = self.args.fap_src_path
+            self.args.fap_dst_dir = self.args.fap_dst_dir.rstrip("/\\")
+
+            if not os.path.isfile(fap_local_path):
+                self.logger.error(f"Error: source .fap ({fap_local_path}) not found")
+                return -1
+
+            fap_dst_path = posixpath.join(
+                self.args.fap_dst_dir, os.path.basename(fap_local_path)
+            )
+
+            self.logger.info(f'Installing "{fap_local_path}" to {fap_dst_path}')
+
+            if not self.mkdir_on_storage(storage, self.args.fap_dst_dir):
+                self.logger.error(f"Error: cannot create dir: {storage.last_error}")
+                return -2
+
+            if not self.send_file_to_storage(
+                storage, fap_dst_path, fap_local_path, False
+            ):
+                self.logger.error(f"Error: upload failed: {storage.last_error}")
+                return -3
+
+            storage.send_and_wait_eol(f'loader open "Applications" {fap_dst_path}\r')
+            result = storage.read.until(storage.CLI_EOL)
+            if len(result):
+                self.logger.error(f"Unexpected response: {result.decode('ascii')}")
+                return -4
+
+            return 0
+        finally:
+            storage.stop()
+
+
+if __name__ == "__main__":
+    Main()()