ff4287e2ce
- Rename `assets` and `config` partitions to `system` and `data` - Change partition type from `spiffs` to `fat`, so we can have sub-directories - Fix crash when doing WiFi scan: Increased system event task size to 3kB. - Free up IRAM on ESP32 (it was required for the Core2, but I also freed up the same amount for Yellow Board) - Introduced `Paths` objects that can be retrieved by `AppContext` and `ServiceContext`. Apps and services now have their own relative paths. Assets were re-arranged into the correct paths. - Rename simulator window title to "Tactility" - Refactored statusbar widget so it persists icon paths properly (it kept a const char* reference, but didn't copy it, so it crashed when the related std::string was destroyed) - Created `Partitions.h` to expose some useful variables - Moved USB config in various `sdkconfig` (it was part of the "default" section, but it shouldn't be) - Updated domain name
92 lines
2.6 KiB
C++
92 lines
2.6 KiB
C++
#pragma once
|
|
|
|
#include "app/AppContext.h"
|
|
#include "app/AppManifest.h"
|
|
#include "Bundle.h"
|
|
#include "Mutex.h"
|
|
#include <memory>
|
|
#include <utility>
|
|
|
|
namespace tt::app {
|
|
|
|
typedef enum {
|
|
StateInitial, // App is being activated in loader
|
|
StateStarted, // App is in memory
|
|
StateShowing, // App view is created
|
|
StateHiding, // App view is destroyed
|
|
StateStopped // App is not in memory
|
|
} State;
|
|
|
|
struct ResultHolder {
|
|
Result result;
|
|
std::shared_ptr<const Bundle> resultData;
|
|
|
|
explicit ResultHolder(Result result) : result(result), resultData(nullptr) {}
|
|
|
|
ResultHolder(Result result, std::shared_ptr<const Bundle> resultData) :
|
|
result(result),
|
|
resultData(std::move(resultData))
|
|
{}
|
|
|
|
};
|
|
|
|
/**
|
|
* Thread-safe app instance.
|
|
*/
|
|
class AppInstance : public AppContext {
|
|
|
|
private:
|
|
|
|
Mutex mutex = Mutex(Mutex::TypeNormal);
|
|
const AppManifest& manifest;
|
|
State state = StateInitial;
|
|
Flags flags = { .showStatusbar = true };
|
|
/** @brief Optional parameters to start the app with
|
|
* When these are stored in the app struct, the struct takes ownership.
|
|
* Do not mutate after app creation.
|
|
*/
|
|
std::shared_ptr<const tt::Bundle> _Nullable parameters;
|
|
/** @brief @brief Contextual data related to the running app's instance
|
|
* The app can attach its data to this.
|
|
* The lifecycle is determined by the on_start and on_stop methods in the AppManifest.
|
|
* These manifest methods can optionally allocate/free data that is attached here.
|
|
*/
|
|
std::shared_ptr<void> _Nullable data;
|
|
std::unique_ptr<ResultHolder> _Nullable resultHolder;
|
|
|
|
public:
|
|
|
|
explicit AppInstance(const AppManifest& manifest) :
|
|
manifest(manifest) {}
|
|
|
|
AppInstance(const AppManifest& manifest, std::shared_ptr<const Bundle> parameters) :
|
|
manifest(manifest),
|
|
parameters(std::move(parameters)) {}
|
|
|
|
~AppInstance() override = default;
|
|
|
|
void setState(State state);
|
|
State getState() const;
|
|
|
|
const AppManifest& getManifest() const override;
|
|
|
|
Flags getFlags() const override;
|
|
void setFlags(Flags flags);
|
|
Flags& mutableFlags() { return flags; } // TODO: locking mechanism
|
|
|
|
std::shared_ptr<void> _Nullable getData() const override;
|
|
void setData(std::shared_ptr<void> data) override;
|
|
|
|
std::shared_ptr<const Bundle> getParameters() const override;
|
|
|
|
void setResult(Result result) override;
|
|
void setResult(Result result, std::shared_ptr<const Bundle> bundle) override;
|
|
bool hasResult() const override;
|
|
|
|
std::unique_ptr<Paths> getPaths() const override;
|
|
|
|
std::unique_ptr<ResultHolder>& getResult() { return resultHolder; }
|
|
};
|
|
|
|
} // namespace
|