3ea02d912f
- WiFi Connect app is now hidden by default, but accessible at the bottom of the WiFi Manage app when WiFi is turned on. - WiFi service now turns on WiFi when calling connect() and WiFi is not on. - Removed `blocking` option for `service::loader::startApp()`. This feature was unused and complex. - Various apps: Moved private headers into Private/ folder. - Various apps: created start() function for easy starting. - Added documentation to all TactilityC APIs - Refactored various `enum` into `class enum` - Refactor M5Stack `initBoot()` (but VBus is still 0V for some reason)
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::Type::Normal);
|
|
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
|