2691dbb014
- Implemented `LaunchId` to keep track of the apps that are started - Implemented `FileSelection` app to select existing and/or new files. - Moved some re-usable file functionality to `tt::file::` - Renamed `Files` app to `FileBrowser` - Updated `Notes` app to use new `FileSelection` functionality, and cleaned it up a bit. - General code cleanliness improvements
98 lines
2.8 KiB
C++
98 lines
2.8 KiB
C++
#pragma once
|
|
|
|
#include "Tactility/app/AppContext.h"
|
|
|
|
#include <Tactility/Bundle.h>
|
|
#include <Tactility/Mutex.h>
|
|
|
|
#include <string>
|
|
|
|
// Forward declarations
|
|
typedef struct _lv_obj_t lv_obj_t;
|
|
|
|
namespace tt::app {
|
|
|
|
// Forward declarations
|
|
class AppContext;
|
|
enum class Result;
|
|
|
|
typedef unsigned int LaunchId;
|
|
|
|
class App {
|
|
|
|
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, LaunchId launchId, 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 lock = getMutex().asScopedLock();
|
|
lock.lock();
|
|
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 lock = getMutex().asScopedLock();
|
|
lock.lock();
|
|
|
|
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
|
|
*/
|
|
LaunchId 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<AppContext> _Nullable getCurrentAppContext();
|
|
|
|
/** @return the currently running app (it is only ever null before the splash screen is shown) */
|
|
std::shared_ptr<App> _Nullable getCurrentApp();
|
|
|
|
}
|