[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>

applications/main/archive/scenes/archive_scene.c

@@ -0,0 +1,30 @@
+#include "archive_scene.h"
+
+// Generate scene on_enter handlers array
+#define ADD_SCENE(prefix, name, id) prefix##_scene_##name##_on_enter,
+void (*const archive_on_enter_handlers[])(void*) = {
+#include "archive_scene_config.h"
+};
+#undef ADD_SCENE
+
+// Generate scene on_event handlers array
+#define ADD_SCENE(prefix, name, id) prefix##_scene_##name##_on_event,
+bool (*const archive_on_event_handlers[])(void* context, SceneManagerEvent event) = {
+#include "archive_scene_config.h"
+};
+#undef ADD_SCENE
+
+// Generate scene on_exit handlers array
+#define ADD_SCENE(prefix, name, id) prefix##_scene_##name##_on_exit,
+void (*const archive_on_exit_handlers[])(void* context) = {
+#include "archive_scene_config.h"
+};
+#undef ADD_SCENE
+
+// Initialize scene handlers configuration structure
+const SceneManagerHandlers archive_scene_handlers = {
+    .on_enter_handlers = archive_on_enter_handlers,
+    .on_event_handlers = archive_on_event_handlers,
+    .on_exit_handlers = archive_on_exit_handlers,
+    .scene_num = ArchiveAppSceneNum,
+};

applications/main/archive/scenes/archive_scene.h

@@ -0,0 +1,29 @@
+#pragma once
+
+#include <gui/scene_manager.h>
+
+// Generate scene id and total number
+#define ADD_SCENE(prefix, name, id) ArchiveAppScene##id,
+typedef enum {
+#include "archive_scene_config.h"
+    ArchiveAppSceneNum,
+} ArchiveAppScene;
+#undef ADD_SCENE
+
+extern const SceneManagerHandlers archive_scene_handlers;
+
+// Generate scene on_enter handlers declaration
+#define ADD_SCENE(prefix, name, id) void prefix##_scene_##name##_on_enter(void*);
+#include "archive_scene_config.h"
+#undef ADD_SCENE
+
+// Generate scene on_event handlers declaration
+#define ADD_SCENE(prefix, name, id) \
+    bool prefix##_scene_##name##_on_event(void* context, SceneManagerEvent event);
+#include "archive_scene_config.h"
+#undef ADD_SCENE
+
+// Generate scene on_exit handlers declaration
+#define ADD_SCENE(prefix, name, id) void prefix##_scene_##name##_on_exit(void* context);
+#include "archive_scene_config.h"
+#undef ADD_SCENE

applications/main/archive/scenes/archive_scene_browser.c

@@ -0,0 +1,221 @@
+#include "../archive_i.h"
+#include "../helpers/archive_files.h"
+#include "../helpers/archive_apps.h"
+#include "../helpers/archive_favorites.h"
+#include "../helpers/archive_browser.h"
+#include "../views/archive_browser_view.h"
+#include "archive/scenes/archive_scene.h"
+
+#define TAG "ArchiveSceneBrowser"
+
+#define SCENE_STATE_DEFAULT (0)
+#define SCENE_STATE_NEED_REFRESH (1)
+
+static const char* flipper_app_name[] = {
+    [ArchiveFileTypeIButton] = "iButton",
+    [ArchiveFileTypeNFC] = "NFC",
+    [ArchiveFileTypeSubGhz] = "Sub-GHz",
+    [ArchiveFileTypeLFRFID] = "125 kHz RFID",
+    [ArchiveFileTypeInfrared] = "Infrared",
+    [ArchiveFileTypeBadUsb] = "Bad USB",
+    [ArchiveFileTypeU2f] = "U2F",
+    [ArchiveFileTypeUpdateManifest] = "UpdaterApp",
+};
+
+static void archive_loader_callback(const void* message, void* context) {
+    furi_assert(message);
+    furi_assert(context);
+    const LoaderEvent* event = message;
+    ArchiveApp* archive = (ArchiveApp*)context;
+
+    if(event->type == LoaderEventTypeApplicationStopped) {
+        view_dispatcher_send_custom_event(
+            archive->view_dispatcher, ArchiveBrowserEventListRefresh);
+    }
+}
+
+static void archive_run_in_app(ArchiveBrowserView* browser, ArchiveFile_t* selected) {
+    UNUSED(browser);
+    Loader* loader = furi_record_open(RECORD_LOADER);
+
+    LoaderStatus status;
+    if(selected->is_app) {
+        char* param = strrchr(string_get_cstr(selected->path), '/');
+        if(param != NULL) {
+            param++;
+        }
+        status = loader_start(loader, flipper_app_name[selected->type], param);
+    } else {
+        status = loader_start(
+            loader, flipper_app_name[selected->type], string_get_cstr(selected->path));
+    }
+
+    if(status != LoaderStatusOk) {
+        FURI_LOG_E(TAG, "loader_start failed: %d", status);
+    }
+
+    furi_record_close(RECORD_LOADER);
+}
+
+void archive_scene_browser_callback(ArchiveBrowserEvent event, void* context) {
+    ArchiveApp* archive = (ArchiveApp*)context;
+    view_dispatcher_send_custom_event(archive->view_dispatcher, event);
+}
+
+void archive_scene_browser_on_enter(void* context) {
+    ArchiveApp* archive = (ArchiveApp*)context;
+    ArchiveBrowserView* browser = archive->browser;
+    browser->is_root = true;
+
+    archive_browser_set_callback(browser, archive_scene_browser_callback, archive);
+    archive_update_focus(browser, archive->text_store);
+    view_dispatcher_switch_to_view(archive->view_dispatcher, ArchiveViewBrowser);
+
+    Loader* loader = furi_record_open(RECORD_LOADER);
+    archive->loader_stop_subscription =
+        furi_pubsub_subscribe(loader_get_pubsub(loader), archive_loader_callback, archive);
+    furi_record_close(RECORD_LOADER);
+
+    uint32_t state = scene_manager_get_scene_state(archive->scene_manager, ArchiveAppSceneBrowser);
+
+    if(state == SCENE_STATE_NEED_REFRESH) {
+        view_dispatcher_send_custom_event(
+            archive->view_dispatcher, ArchiveBrowserEventListRefresh);
+    }
+
+    scene_manager_set_scene_state(
+        archive->scene_manager, ArchiveAppSceneBrowser, SCENE_STATE_DEFAULT);
+}
+
+bool archive_scene_browser_on_event(void* context, SceneManagerEvent event) {
+    ArchiveApp* archive = (ArchiveApp*)context;
+    ArchiveBrowserView* browser = archive->browser;
+    ArchiveFile_t* selected = archive_get_current_file(browser);
+
+    bool favorites = archive_get_tab(browser) == ArchiveTabFavorites;
+    bool consumed = false;
+
+    if(event.type == SceneManagerEventTypeCustom) {
+        switch(event.event) {
+        case ArchiveBrowserEventFileMenuOpen:
+            archive_show_file_menu(browser, true);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventFileMenuClose:
+            archive_show_file_menu(browser, false);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventFileMenuRun:
+            if(archive_is_known_app(selected->type)) {
+                archive_run_in_app(browser, selected);
+                archive_show_file_menu(browser, false);
+            }
+            consumed = true;
+            break;
+        case ArchiveBrowserEventFileMenuPin: {
+            const char* name = archive_get_name(browser);
+            if(favorites) {
+                archive_favorites_delete(name);
+                archive_file_array_rm_selected(browser);
+                archive_show_file_menu(browser, false);
+            } else if(archive_is_known_app(selected->type)) {
+                if(archive_is_favorite("%s", name)) {
+                    archive_favorites_delete("%s", name);
+                } else {
+                    archive_file_append(ARCHIVE_FAV_PATH, "%s\n", name);
+                }
+                archive_show_file_menu(browser, false);
+            }
+            consumed = true;
+        } break;
+
+        case ArchiveBrowserEventFileMenuRename:
+            if(favorites) {
+                browser->callback(ArchiveBrowserEventEnterFavMove, browser->context);
+            } else if((archive_is_known_app(selected->type)) && (selected->is_app == false)) {
+                archive_show_file_menu(browser, false);
+                scene_manager_set_scene_state(
+                    archive->scene_manager, ArchiveAppSceneBrowser, SCENE_STATE_NEED_REFRESH);
+                scene_manager_next_scene(archive->scene_manager, ArchiveAppSceneRename);
+            }
+            consumed = true;
+            break;
+        case ArchiveBrowserEventFileMenuDelete:
+            if(archive_get_tab(browser) != ArchiveTabFavorites) {
+                scene_manager_next_scene(archive->scene_manager, ArchiveAppSceneDelete);
+            }
+            consumed = true;
+            break;
+        case ArchiveBrowserEventEnterDir:
+            archive_enter_dir(browser, selected->path);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventFavMoveUp:
+            archive_file_array_swap(browser, 1);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventFavMoveDown:
+            archive_file_array_swap(browser, -1);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventEnterFavMove:
+            string_set(archive->fav_move_str, selected->path);
+            archive_show_file_menu(browser, false);
+            archive_favorites_move_mode(archive->browser, true);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventExitFavMove:
+            archive_update_focus(browser, string_get_cstr(archive->fav_move_str));
+            archive_favorites_move_mode(archive->browser, false);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventSaveFavMove:
+            archive_favorites_move_mode(archive->browser, false);
+            archive_favorites_save(archive->browser);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventLoadPrevItems:
+            archive_file_array_load(archive->browser, -1);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventLoadNextItems:
+            archive_file_array_load(archive->browser, 1);
+            consumed = true;
+            break;
+        case ArchiveBrowserEventListRefresh:
+            if(!favorites) {
+                archive_refresh_dir(browser);
+            } else {
+                archive_favorites_read(browser);
+            }
+            consumed = true;
+            break;
+
+        case ArchiveBrowserEventExit:
+            if(!archive_is_home(browser)) {
+                archive_leave_dir(browser);
+            } else {
+                Loader* loader = furi_record_open(RECORD_LOADER);
+                furi_pubsub_unsubscribe(
+                    loader_get_pubsub(loader), archive->loader_stop_subscription);
+                furi_record_close(RECORD_LOADER);
+
+                view_dispatcher_stop(archive->view_dispatcher);
+            }
+            consumed = true;
+            break;
+
+        default:
+            break;
+        }
+    }
+    return consumed;
+}
+
+void archive_scene_browser_on_exit(void* context) {
+    ArchiveApp* archive = (ArchiveApp*)context;
+
+    Loader* loader = furi_record_open(RECORD_LOADER);
+    furi_pubsub_unsubscribe(loader_get_pubsub(loader), archive->loader_stop_subscription);
+    furi_record_close(RECORD_LOADER);
+}

applications/main/archive/scenes/archive_scene_config.h

@@ -0,0 +1,3 @@
+ADD_SCENE(archive, browser, Browser)
+ADD_SCENE(archive, rename, Rename)
+ADD_SCENE(archive, delete, Delete)

applications/main/archive/scenes/archive_scene_delete.c

@@ -0,0 +1,74 @@
+#include "../archive_i.h"
+#include "../helpers/archive_favorites.h"
+#include "../helpers/archive_files.h"
+#include "../helpers/archive_apps.h"
+#include "../helpers/archive_browser.h"
+#include "toolbox/path.h"
+#include "m-string.h"
+
+#define SCENE_DELETE_CUSTOM_EVENT (0UL)
+#define MAX_TEXT_INPUT_LEN 22
+
+void archive_scene_delete_widget_callback(GuiButtonType result, InputType type, void* context) {
+    furi_assert(context);
+    ArchiveApp* app = (ArchiveApp*)context;
+    if(type == InputTypeShort) {
+        view_dispatcher_send_custom_event(app->view_dispatcher, result);
+    }
+}
+
+void archive_scene_delete_on_enter(void* context) {
+    furi_assert(context);
+    ArchiveApp* app = (ArchiveApp*)context;
+
+    widget_add_button_element(
+        app->widget, GuiButtonTypeLeft, "Cancel", archive_scene_delete_widget_callback, app);
+    widget_add_button_element(
+        app->widget, GuiButtonTypeRight, "Delete", archive_scene_delete_widget_callback, app);
+
+    string_t filename;
+    string_init(filename);
+
+    ArchiveFile_t* current = archive_get_current_file(app->browser);
+    path_extract_filename(current->path, filename, false);
+
+    char delete_str[64];
+    snprintf(delete_str, sizeof(delete_str), "\e#Delete %s?\e#", string_get_cstr(filename));
+    widget_add_text_box_element(
+        app->widget, 0, 0, 128, 23, AlignCenter, AlignCenter, delete_str, false);
+
+    string_clear(filename);
+
+    view_dispatcher_switch_to_view(app->view_dispatcher, ArchiveViewWidget);
+}
+
+bool archive_scene_delete_on_event(void* context, SceneManagerEvent event) {
+    furi_assert(context);
+    ArchiveApp* app = (ArchiveApp*)context;
+
+    ArchiveBrowserView* browser = app->browser;
+    ArchiveFile_t* selected = archive_get_current_file(browser);
+    const char* name = archive_get_name(browser);
+
+    if(event.type == SceneManagerEventTypeCustom) {
+        if(event.event == GuiButtonTypeRight) {
+            if(selected->is_app) {
+                archive_app_delete_file(browser, name);
+            } else {
+                archive_delete_file(browser, "%s", name);
+            }
+            archive_show_file_menu(browser, false);
+            return scene_manager_previous_scene(app->scene_manager);
+        } else if(event.event == GuiButtonTypeLeft) {
+            return scene_manager_previous_scene(app->scene_manager);
+        }
+    }
+    return false;
+}
+
+void archive_scene_delete_on_exit(void* context) {
+    furi_assert(context);
+    ArchiveApp* app = (ArchiveApp*)context;
+
+    widget_reset(app->widget);
+}

applications/main/archive/scenes/archive_scene_rename.c

@@ -0,0 +1,89 @@
+#include "../archive_i.h"
+#include "../helpers/archive_favorites.h"
+#include "../helpers/archive_files.h"
+#include "../helpers/archive_browser.h"
+#include "archive/views/archive_browser_view.h"
+#include "toolbox/path.h"
+
+#define SCENE_RENAME_CUSTOM_EVENT (0UL)
+#define MAX_TEXT_INPUT_LEN 22
+
+void archive_scene_rename_text_input_callback(void* context) {
+    ArchiveApp* archive = (ArchiveApp*)context;
+    view_dispatcher_send_custom_event(archive->view_dispatcher, SCENE_RENAME_CUSTOM_EVENT);
+}
+
+void archive_scene_rename_on_enter(void* context) {
+    ArchiveApp* archive = (ArchiveApp*)context;
+
+    TextInput* text_input = archive->text_input;
+    ArchiveFile_t* current = archive_get_current_file(archive->browser);
+
+    string_t filename;
+    string_init(filename);
+    path_extract_filename(current->path, filename, true);
+    strlcpy(archive->text_store, string_get_cstr(filename), MAX_NAME_LEN);
+
+    path_extract_extension(current->path, archive->file_extension, MAX_EXT_LEN);
+
+    text_input_set_header_text(text_input, "Rename:");
+
+    text_input_set_result_callback(
+        text_input,
+        archive_scene_rename_text_input_callback,
+        archive,
+        archive->text_store,
+        MAX_TEXT_INPUT_LEN,
+        false);
+
+    ValidatorIsFile* validator_is_file = validator_is_file_alloc_init(
+        string_get_cstr(archive->browser->path), archive->file_extension, "");
+    text_input_set_validator(text_input, validator_is_file_callback, validator_is_file);
+
+    string_clear(filename);
+
+    view_dispatcher_switch_to_view(archive->view_dispatcher, ArchiveViewTextInput);
+}
+
+bool archive_scene_rename_on_event(void* context, SceneManagerEvent event) {
+    ArchiveApp* archive = (ArchiveApp*)context;
+    bool consumed = false;
+
+    if(event.type == SceneManagerEventTypeCustom) {
+        if(event.event == SCENE_RENAME_CUSTOM_EVENT) {
+            Storage* fs_api = furi_record_open(RECORD_STORAGE);
+
+            const char* path_src = archive_get_name(archive->browser);
+            ArchiveFile_t* file = archive_get_current_file(archive->browser);
+
+            string_t path_dst;
+            string_init(path_dst);
+            path_extract_dirname(path_src, path_dst);
+            string_cat_printf(path_dst, "/%s%s", archive->text_store, known_ext[file->type]);
+
+            storage_common_rename(fs_api, path_src, string_get_cstr(path_dst));
+            furi_record_close(RECORD_STORAGE);
+
+            if(file->fav) {
+                archive_favorites_rename(path_src, string_get_cstr(path_dst));
+            }
+
+            string_clear(path_dst);
+
+            scene_manager_next_scene(archive->scene_manager, ArchiveAppSceneBrowser);
+            consumed = true;
+        }
+    }
+    return consumed;
+}
+
+void archive_scene_rename_on_exit(void* context) {
+    ArchiveApp* archive = (ArchiveApp*)context;
+
+    // Clear view
+    void* validator_context = text_input_get_validator_callback_context(archive->text_input);
+    text_input_set_validator(archive->text_input, NULL, NULL);
+    validator_is_file_free(validator_context);
+
+    text_input_reset(archive->text_input);
+}