feat: add retained underlay runtime controls

This commit is contained in:
tei
2026-09-22 16:18:58 +09:00
parent 9ad2fe5d58
commit 8384c8bd24
31 changed files with 1181 additions and 59 deletions

View File

@@ -111,6 +111,22 @@ public final class MapLibreMap {
nativeMapView.triggerRepaint();
}
/** Enables or disables the renderer's map-scoped retained static underlay optimization. */
public void setRetainedUnderlayEnabled(boolean enabled) {
nativeMapView.setRetainedUnderlayEnabled(enabled);
}
/** Returns whether the retained static underlay optimization is enabled for this map. */
public boolean isRetainedUnderlayEnabled() {
return nativeMapView.getRetainedUnderlayDiagnostics().enabled;
}
/** Returns a thread-safe, pull-based retained-underlay diagnostics snapshot. */
@NonNull
public RetainedUnderlayDiagnostics getRetainedUnderlayDiagnostics() {
return nativeMapView.getRetainedUnderlayDiagnostics();
}
/**
* Query rendering statistics overlay status.
*/

View File

@@ -286,6 +286,10 @@ interface NativeMap {
boolean getDebug();
void setRetainedUnderlayEnabled(boolean enabled);
RetainedUnderlayDiagnostics getRetainedUnderlayDiagnostics();
String[] getActionJournalLogFiles();
String[] getActionJournalLog();

View File

@@ -653,6 +653,22 @@ final class NativeMapView implements NativeMap {
return nativeGetDebug();
}
@Override
public void setRetainedUnderlayEnabled(boolean enabled) {
if (checkState("setRetainedUnderlayEnabled")) {
return;
}
nativeSetRetainedUnderlayEnabled(enabled);
}
@Override
public RetainedUnderlayDiagnostics getRetainedUnderlayDiagnostics() {
if (checkState("getRetainedUnderlayDiagnostics")) {
return new RetainedUnderlayDiagnostics(new String[] {"true", "0", "0", "0", "0", "unavailable"});
}
return new RetainedUnderlayDiagnostics(nativeGetRetainedUnderlayDiagnostics());
}
@Override
public String[] getActionJournalLogFiles() {
if (checkState("getActionJournalLogFiles")) {
@@ -1702,6 +1718,12 @@ final class NativeMapView implements NativeMap {
@Keep
private native boolean nativeGetDebug();
@Keep
private native void nativeSetRetainedUnderlayEnabled(boolean enabled);
@Keep
private native String[] nativeGetRetainedUnderlayDiagnostics();
@Keep
private native String[] nativeGetActionJournalLogFiles();

View File

@@ -0,0 +1,27 @@
package org.maplibre.android.maps;
import androidx.annotation.Keep;
import androidx.annotation.NonNull;
/** A pull-based snapshot of this map's retained-underlay renderer state. */
@Keep
public final class RetainedUnderlayDiagnostics {
public final boolean enabled;
public final long build;
public final long reuse;
public final long fallback;
public final long invalidation;
@NonNull public final String lastReason;
RetainedUnderlayDiagnostics(@NonNull String[] values) {
if (values.length != 6) {
throw new IllegalArgumentException("Retained-underlay diagnostics require six values");
}
enabled = Boolean.parseBoolean(values[0]);
build = Long.parseLong(values[1]);
reuse = Long.parseLong(values[2]);
fallback = Long.parseLong(values[3]);
invalidation = Long.parseLong(values[4]);
lastReason = values[5];
}
}