Files
oxmc f6176009b1 Add recovery_ui and recovery_toolkit scaffolding (first draft, not build-tested)
Stages TWRP's GUI engine and standalone tooling as PawletOS-owned modules
instead of a bootable/recovery fork, per the plugin-architecture finding in
NOTES-ota-recovery-ab.md: stock recovery_main.cpp already dlopen()s
librecovery_ui_ext.so and dlsym()s make_device() from it at runtime, so the
UI layer doesn't require touching stock bootable/recovery at all. Confirmed
via source grep that recovery.cpp/install.cpp have zero references into the
partition manager/backup engine/GUI code and vice versa.

recovery_ui/: TWRP's gui/, minuitwrp/, libpixelflinger/ (copied verbatim,
GPL-3.0), plus a new device/ providing PawletTwrpUI (a ScreenRecoveryUI
subclass) and make_device() — written from scratch against stock's
RecoveryUI/ScreenRecoveryUI virtual-method contract, since TWRP's own fork
never ships a make_device() (every real TWRP device provides its own, and
no reference device tree was available to copy from). Top-level Android.bp
defines librecovery_ui_pawlet_twrp, the module TARGET_RECOVERY_UI_LIB should
point at. gui/Android.bp and minuitwrp/Android.bp had their include_dirs
rewritten for the new paths.

recovery_toolkit/: partition manager, backup engine (tar/digest/adbbu/apex),
filesystem/format support (exfat/dosfstools/gpt/fuse/mtp/crypto), scripting
(openrecoveryscript/orscmd/twrpinstall), shared helpers. Source only, no
Android.bp yet for any of it.

Known gap blocking recovery_ui from actually linking: gui/'s libguitwrp
depends on libaosprecovery, built from recovery_toolkit/helpers/twrp.cpp via
a Go Soong plugin (libaosprecovery_defaults.go) not yet ported. Neither repo
has been build-tested — no local AOSP build environment available in this
workspace. See each directory's README.md for a precise done/not-done
breakdown.
2026-07-11 16:34:35 -07:00

98 lines
2.6 KiB
C++

/*
Copyright 2015 _that/TeamWin
This file is part of TWRP/TeamWin Recovery Project.
TWRP is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
TWRP is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with TWRP. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef twmsg_h
#define twmsg_h
#include <cstdlib>
#include <cstring>
#include <string>
#include <sstream>
#include <vector>
#include <errno.h>
/*
Abstract interface for something that can look up strings by name.
*/
class StringLookup
{
public:
virtual std::string operator()(const std::string& name) const = 0;
virtual ~StringLookup() {};
};
namespace msg
{
// These get translated to colors in the GUI console
enum Kind
{
kNormal,
kHighlight,
kWarning,
kError
};
template<typename T> std::string to_string(const T& v)
{
std::ostringstream ss;
ss << v;
return ss.str();
}
}
/*
Generic message formatting class.
Designed to decouple message generation from actual resource string lookup and variable insertion,
so that messages can be re-translated at any later time.
*/
class Message
{
msg::Kind kind; // severity or similar message kind
std::string name; // the resource string name. may be of format "name=default value".
std::vector<std::string> variables; // collected insertion variables to replace {1}, {2}, ...
const StringLookup& resourceLookup; // object to resolve resource string name into a final format string
const StringLookup& varLookup; // object to resolve any non-numeric insertion strings
std::string GetFormatString(const std::string& name) const;
public:
Message(msg::Kind kind, const char* name, const StringLookup& resourceLookup, const StringLookup& varLookup)
: kind(kind), name(name), resourceLookup(resourceLookup), varLookup(varLookup) {}
// Variable insertion.
template<typename T>
Message& operator()(const T& v) { variables.push_back(msg::to_string(v)); return *this; }
// conversion to final string
operator std::string() const;
// Get Message Kind
msg::Kind GetKind() {return kind;};
};
// Utility functions to create messages with standard resource and data manager lookups.
// Short names to make usage convenient.
Message Msg(const char* name);
Message Msg(msg::Kind kind, const char* name);
#endif