Ken Van Hoeylandt
92ca046681
- Apps can specify task stack depth and preferred memory placement in their manifests. - App identifiers are validated against length and character requirements. - Crash diagnostics now show the crash cause, reason, fault address, call stack, and program-counter details, with logs saved for review. - App closing is more consistent across built-in screens. There's now a dedicated function, and the old _emit() function is made private. - Crash diagnostics no longer display a QR code without a call stack. - Improved memory allocation for unrestricted requests.
75 lines
2.2 KiB
C
75 lines
2.2 KiB
C
// SPDX-License-Identifier: Apache-2.0
|
|
#pragma once
|
|
|
|
#include <tactility/error.h>
|
|
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define APP_METADATA_TARGET_SDK_LENGTH 16
|
|
#define APP_METADATA_APP_ID_LENGTH 32
|
|
#define APP_METADATA_APP_NAME_LENGTH 32
|
|
#define APP_METADATA_APP_VERSION_NAME_LENGTH 16
|
|
#define APP_METADATA_REQUIRES_DEVICE_ID_LENGTH 64
|
|
|
|
struct AppMetadata {
|
|
|
|
/**
|
|
* The SDK version that was used to compile this app. (e.g. "0.6.0")
|
|
* Must be NULL-terminated.
|
|
*/
|
|
char target_sdk[APP_METADATA_TARGET_SDK_LENGTH + 1];
|
|
|
|
/**
|
|
* The identifier by which the app is launched by the system and other apps.
|
|
* Must be NULL-terminated.
|
|
*/
|
|
char app_id[APP_METADATA_APP_ID_LENGTH + 1];
|
|
|
|
/**
|
|
* The user-readable name of the app. Used in UI.
|
|
* Must be NULL-terminated.
|
|
*/
|
|
char app_name[APP_METADATA_APP_NAME_LENGTH + 1];
|
|
|
|
/**
|
|
* The version as it is displayed to the user (e.g. "1.2.0")
|
|
* Must be NULL-terminated.
|
|
*/
|
|
char app_version_name[APP_METADATA_APP_VERSION_NAME_LENGTH + 1];
|
|
|
|
/** The technical version (must be incremented with new releases of the app) */
|
|
uint64_t app_version_code;
|
|
|
|
/**
|
|
* Comma-separated list of device ids the app is restricted to (e.g. "m5stack-tab5"), matching
|
|
* the folder names under Devices/. Empty means unrestricted.
|
|
* Must be NULL-terminated.
|
|
*/
|
|
char requires_device_id[APP_METADATA_REQUIRES_DEVICE_ID_LENGTH + 1];
|
|
|
|
/**
|
|
* Stack depth (in words) for the app's task. Optional; 0 means scheduler default.
|
|
* @warning Avoid default values: the default is conservative, which wastes memory.
|
|
*/
|
|
uint32_t stack_depth;
|
|
};
|
|
|
|
/**
|
|
* Parses a manifest.properties file at @a path into @a out_metadata, auto-detecting the V1
|
|
* (sectioned, e.g. "[app]id=...") or V2 (flat dot-notation, e.g. "app.id=...") format from its
|
|
* first line.
|
|
* @retval ERROR_NONE on success
|
|
* @retval ERROR_NOT_FOUND the file doesn't exist / couldn't be opened
|
|
* @retval ERROR_INVALID_ARGUMENT the file isn't a valid manifest, or a field's value doesn't fit
|
|
* @a out_metadata's fixed-size buffers
|
|
*/
|
|
error_t app_metadata_parse(const char* path, struct AppMetadata* out_metadata);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|