|
| 1 | +/* |
| 2 | + * ============================================================================ |
| 3 | + * Name : ForgejoRepoRefresh.java |
| 4 | + * Author : AppDevForAll |
| 5 | + * Copyright : Copyright (c) 2026 AppDevForAll |
| 6 | + * Description : K2GO-422. The single "Update repos" flow, shared by the module detail button and the |
| 7 | + * module action sheet row so neither duplicates it. It gates like the dashboard update |
| 8 | + * (needs internet, then metered consent), shows minimal inline progress (a description, a |
| 9 | + * live one-line output tail, an indeterminate bar and a Cancel) injected right after the |
| 10 | + * trigger view, runs the box refresh on an IO thread, and reports the outcome in a snackbar. |
| 11 | + * |
| 12 | + * Lifecycle: there is NO persistent app-side state. The box refresh job is detached |
| 13 | + * (setsid), so a host that goes away mid-run (the sheet dismissed, the fragment detached) |
| 14 | + * just drops the UI updates (guarded by View.isAttachedToWindow()); the box finishes on its |
| 15 | + * own and the next /forgejo/status read reflects reality. The only state is the box's own |
| 16 | + * status/pid files, which the box manages. So there is nothing here to leak or to clear. |
| 17 | + * ============================================================================ |
| 18 | + */ |
| 19 | +package org.appdevforall.k2go.forgejo.presentation; |
| 20 | + |
| 21 | +import android.app.Activity; |
| 22 | +import android.content.Context; |
| 23 | +import android.os.Handler; |
| 24 | +import android.os.Looper; |
| 25 | +import android.text.TextUtils; |
| 26 | +import android.view.Gravity; |
| 27 | +import android.view.View; |
| 28 | +import android.view.ViewGroup; |
| 29 | +import android.widget.LinearLayout; |
| 30 | +import android.widget.TextView; |
| 31 | + |
| 32 | +import androidx.annotation.NonNull; |
| 33 | +import androidx.core.content.ContextCompat; |
| 34 | + |
| 35 | +import com.google.android.material.progressindicator.LinearProgressIndicator; |
| 36 | + |
| 37 | +import org.appdevforall.k2go.R; |
| 38 | +import org.appdevforall.k2go.forgejo.data.ForgejoSeedClient; |
| 39 | +import org.appdevforall.k2go.util.AppExecutors; |
| 40 | +import org.appdevforall.k2go.util.Snackbars; |
| 41 | + |
| 42 | +public final class ForgejoRepoRefresh { |
| 43 | + |
| 44 | + private ForgejoRepoRefresh() {} |
| 45 | + |
| 46 | + /** |
| 47 | + * Gate (internet, then metered consent) then run the refresh with progress injected right after |
| 48 | + * {@code trigger}. The trigger stays in place (only disabled) as a visible anchor for the snackbar. |
| 49 | + */ |
| 50 | + public static void start(@NonNull Activity act, @NonNull View trigger) { |
| 51 | + if (!org.appdevforall.k2go.networkpolicy.data.AndroidNetworkClassifier.hasInternet(act)) { |
| 52 | + Snackbars.make(trigger, act.getString(R.string.k2go_dash_needs_internet)).show(); |
| 53 | + return; |
| 54 | + } |
| 55 | + // Same metered gate as the dashboard update: the box git-fetches over the device network. |
| 56 | + org.appdevforall.k2go.networkpolicy.presentation.NetworkPolicyGate.guardHeavyStart(act, () -> run(trigger)); |
| 57 | + } |
| 58 | + |
| 59 | + private static void run(@NonNull View trigger) { |
| 60 | + final ViewGroup parent = (ViewGroup) trigger.getParent(); |
| 61 | + if (parent == null || !trigger.isAttachedToWindow()) return; // host went away during the gate |
| 62 | + final Context ctx = trigger.getContext(); |
| 63 | + final Handler main = new Handler(Looper.getMainLooper()); |
| 64 | + final float d = ctx.getResources().getDisplayMetrics().density; |
| 65 | + final int side = Math.round(20 * d); |
| 66 | + |
| 67 | + final LinearLayout progress = new LinearLayout(ctx); |
| 68 | + progress.setOrientation(LinearLayout.VERTICAL); |
| 69 | + LinearLayout.LayoutParams plp = new LinearLayout.LayoutParams( |
| 70 | + ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT); |
| 71 | + plp.leftMargin = side; plp.rightMargin = side; plp.topMargin = Math.round(8 * d); |
| 72 | + progress.setLayoutParams(plp); |
| 73 | + |
| 74 | + // Description of what is happening (static), then a live line that tails the box output one line at |
| 75 | + // a time (the per-repo outcomes advance like the proot rows: it advances, not a log box). |
| 76 | + final TextView label = new TextView(ctx); |
| 77 | + label.setText(R.string.k2go_forgejo_updating); |
| 78 | + label.setTextAppearance(com.google.android.material.R.style.TextAppearance_Material3_BodySmall); |
| 79 | + label.setTextColor(ContextCompat.getColor(ctx, R.color.k2go_muted)); |
| 80 | + progress.addView(label); |
| 81 | + |
| 82 | + final TextView liveLine = new TextView(ctx); |
| 83 | + liveLine.setTextAppearance(com.google.android.material.R.style.TextAppearance_Material3_BodySmall); |
| 84 | + liveLine.setTextColor(ContextCompat.getColor(ctx, R.color.k2go_muted)); |
| 85 | + liveLine.setMaxLines(1); |
| 86 | + liveLine.setEllipsize(TextUtils.TruncateAt.END); |
| 87 | + LinearLayout.LayoutParams llp = new LinearLayout.LayoutParams( |
| 88 | + ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT); |
| 89 | + llp.topMargin = Math.round(2 * d); |
| 90 | + liveLine.setLayoutParams(llp); |
| 91 | + progress.addView(liveLine); |
| 92 | + |
| 93 | + // The bar and Cancel share one line: the bar takes the width, Cancel sits beside it. |
| 94 | + final LinearLayout barLine = new LinearLayout(ctx); |
| 95 | + barLine.setOrientation(LinearLayout.HORIZONTAL); |
| 96 | + barLine.setGravity(Gravity.CENTER_VERTICAL); |
| 97 | + LinearLayout.LayoutParams barLineLp = new LinearLayout.LayoutParams( |
| 98 | + ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT); |
| 99 | + barLineLp.topMargin = Math.round(4 * d); |
| 100 | + barLine.setLayoutParams(barLineLp); |
| 101 | + |
| 102 | + final LinearProgressIndicator bar = new LinearProgressIndicator(ctx); |
| 103 | + bar.setIndeterminate(true); |
| 104 | + LinearLayout.LayoutParams blp = new LinearLayout.LayoutParams(0, ViewGroup.LayoutParams.WRAP_CONTENT, 1f); |
| 105 | + bar.setLayoutParams(blp); |
| 106 | + barLine.addView(bar); |
| 107 | + |
| 108 | + final TextView cancel = new TextView(ctx); |
| 109 | + cancel.setText(R.string.k2go_dash_cancel); |
| 110 | + cancel.setAllCaps(true); |
| 111 | + cancel.setTextAppearance(com.google.android.material.R.style.TextAppearance_Material3_LabelLarge); |
| 112 | + cancel.setTextColor(ContextCompat.getColor(ctx, R.color.k2go_teal)); |
| 113 | + int hp = Math.round(12 * d), vp = Math.round(6 * d); |
| 114 | + cancel.setPadding(hp, vp, hp, vp); |
| 115 | + barLine.addView(cancel); |
| 116 | + progress.addView(barLine); |
| 117 | + |
| 118 | + parent.addView(progress, parent.indexOfChild(trigger) + 1); |
| 119 | + trigger.setEnabled(false); // stays in place as an anchor; re-enabled when the refresh settles |
| 120 | + |
| 121 | + cancel.setOnClickListener(cv -> { |
| 122 | + cancel.setEnabled(false); |
| 123 | + label.setText(R.string.k2go_forgejo_update_cancelling); |
| 124 | + AppExecutors.get().io().execute(() -> new ForgejoSeedClient().cancelRefresh()); |
| 125 | + }); |
| 126 | + |
| 127 | + AppExecutors.get().io().execute(() -> { |
| 128 | + final ForgejoSeedClient client = new ForgejoSeedClient(); |
| 129 | + final ForgejoSeedClient.Result r = client.refresh(rawLine -> { |
| 130 | + // Tail one line at a time, trimmed and without the org prefix, so it reads cleanly. |
| 131 | + final String shown = rawLine.trim().replace("AppDevForAll/", ""); |
| 132 | + main.post(() -> { if (liveLine.isAttachedToWindow()) liveLine.setText(shown); }); |
| 133 | + }); |
| 134 | + // The box reports per-repo outcome counts on the refresh status (advanced / could-not / total). |
| 135 | + final int changed = client.lastChanged(); |
| 136 | + final int problems = client.lastProblems(); |
| 137 | + final int total = client.lastTotal(); |
| 138 | + main.post(() -> { |
| 139 | + if (!trigger.isAttachedToWindow()) return; |
| 140 | + parent.removeView(progress); |
| 141 | + trigger.setEnabled(true); |
| 142 | + Snackbars.make(trigger, ctx.getString(messageFor(r, changed, problems, total))).show(); |
| 143 | + }); |
| 144 | + }); |
| 145 | + } |
| 146 | + |
| 147 | + /** Map the refresh outcome to a user message covering every state. */ |
| 148 | + private static int messageFor(ForgejoSeedClient.Result r, int changed, int problems, int total) { |
| 149 | + if (r == ForgejoSeedClient.Result.CANCELLED) return R.string.k2go_forgejo_update_cancelled; |
| 150 | + if (r != ForgejoSeedClient.Result.DONE) return R.string.k2go_forgejo_update_failed; // box unreachable |
| 151 | + if (problems > 0) { |
| 152 | + // some repos could not be updated (conflict or a fetch/push failure); reconcile in the web UI |
| 153 | + return (total - problems > 0) ? R.string.k2go_forgejo_update_some_failed |
| 154 | + : R.string.k2go_forgejo_update_all_failed; |
| 155 | + } |
| 156 | + if (changed > 0) return R.string.k2go_forgejo_update_done; // at least one repo advanced |
| 157 | + if (changed == 0) return R.string.k2go_forgejo_update_none; // nothing to update |
| 158 | + return R.string.k2go_forgejo_update_done; // unknown counts (older box) |
| 159 | + } |
| 160 | +} |
0 commit comments