7856827ecf
When writing documentation, I realized how `onStart`/`onStop` isn't clearly communicating what it does (it could imply show/hide), so I renamed it to `onCreate` and `onDestroy`.
96 lines
2.7 KiB
C++
96 lines
2.7 KiB
C++
#pragma once
|
|
|
|
#include "AppContext.h"
|
|
#include "Bundle.h"
|
|
#include <Mutex.h>
|
|
#include <string>
|
|
|
|
// Forward declarations
|
|
typedef struct _lv_obj_t lv_obj_t;
|
|
|
|
namespace tt::app {
|
|
|
|
// Forward declarations
|
|
class AppContext;
|
|
enum class Result;
|
|
|
|
class App {
|
|
|
|
private:
|
|
|
|
Mutex mutex;
|
|
|
|
struct ResultHolder {
|
|
Result result;
|
|
std::unique_ptr<Bundle> resultData;
|
|
|
|
explicit ResultHolder(Result result) : result(result), resultData(nullptr) {}
|
|
|
|
ResultHolder(Result result, std::unique_ptr<Bundle> resultData) :
|
|
result(result),
|
|
resultData(std::move(resultData)) {}
|
|
};
|
|
|
|
std::unique_ptr<ResultHolder> resultHolder;
|
|
|
|
public:
|
|
|
|
App() = default;
|
|
virtual ~App() = default;
|
|
|
|
virtual void onCreate(AppContext& appContext) {}
|
|
virtual void onDestroy(AppContext& appContext) {}
|
|
virtual void onShow(AppContext& appContext, lv_obj_t* parent) {}
|
|
virtual void onHide(AppContext& appContext) {}
|
|
virtual void onResult(AppContext& appContext, Result result, std::unique_ptr<Bundle> _Nullable resultData) {}
|
|
|
|
Mutex& getMutex() { return mutex; }
|
|
|
|
bool hasResult() const { return resultHolder != nullptr; }
|
|
|
|
void setResult(Result result, std::unique_ptr<Bundle> resultData = nullptr) {
|
|
auto lockable = getMutex().scoped();
|
|
lockable->lock(portMAX_DELAY);
|
|
resultHolder = std::make_unique<ResultHolder>(result, std::move(resultData));
|
|
}
|
|
|
|
/**
|
|
* Used by system to extract the result data when this application is finished.
|
|
* Note that this removes the data from the class!
|
|
*/
|
|
bool moveResult(Result& outResult, std::unique_ptr<Bundle>& outBundle) {
|
|
auto lockable = getMutex().scoped();
|
|
lockable->lock(portMAX_DELAY);
|
|
|
|
if (resultHolder != nullptr) {
|
|
outResult = resultHolder->result;
|
|
outBundle = std::move(resultHolder->resultData);
|
|
resultHolder = nullptr;
|
|
return true;
|
|
} else {
|
|
return false;
|
|
}
|
|
}
|
|
};
|
|
|
|
template<typename T>
|
|
std::shared_ptr<App> create() { return std::shared_ptr<T>(new T); }
|
|
|
|
/**
|
|
* @brief Start an app
|
|
* @param[in] id application name or id
|
|
* @param[in] parameters optional parameters to pass onto the application
|
|
*/
|
|
void start(const std::string& id, std::shared_ptr<const Bundle> _Nullable parameters = nullptr);
|
|
|
|
/** @brief Stop the currently showing app. Show the previous app if any app was still running. */
|
|
void stop();
|
|
|
|
/** @return the currently running app context (it is only ever null before the splash screen is shown) */
|
|
std::shared_ptr<app::AppContext> _Nullable getCurrentAppContext();
|
|
|
|
/** @return the currently running app (it is only ever null before the splash screen is shown) */
|
|
std::shared_ptr<app::App> _Nullable getCurrentApp();
|
|
|
|
}
|