fix: 统一主应用更新检查行为

Author: Jeric-X

App.tsx

@@ -14,11 +14,34 @@ import { useTheme } from './src/hooks/useTheme';
 import { setDynamicShortcuts } from 'shortcut';
 import { moveTaskToBack, setExcludeFromRecents } from 'native-util';
 import { networkAutoSwitchService } from './src/services/NetworkAutoSwitchService';
-import {
-  isShareIntentUrl,
-  parseQuickTileUrl,
-  shouldEnableAutoUpdateCheck,
-} from './src/utils/appLaunch';
+
+const QUICK_UPLOAD_URL = 'syncclipboard://quick-upload';
+const QUICK_DOWNLOAD_URL = 'syncclipboard://quick-download';
+
+function parseQuickTileUrl(url: string | null): {
+  isQuickTile: boolean;
+  fromForeground: boolean;
+  direction: SyncDirection;
+} {
+  if (!url) return { isQuickTile: false, fromForeground: false, direction: SyncDirection.Download };
+  const fromForeground = url.includes('fg=1');
+  if (url.startsWith(QUICK_UPLOAD_URL)) {
+    return { isQuickTile: true, fromForeground, direction: SyncDirection.Upload };
+  }
+  if (url.startsWith(QUICK_DOWNLOAD_URL)) {
+    return { isQuickTile: true, fromForeground, direction: SyncDirection.Download };
+  }
+  return { isQuickTile: false, fromForeground: false, direction: SyncDirection.Download };
+}
+
+function isShareIntentUrl(url: string | null): boolean {
+  if (!url) return false;
+  try {
+    return new URL(url).hostname === 'expo-sharing';
+  } catch {
+    return false;
+  }
+}
 
 async function runOverlayNetworkPreflight(): Promise<void> {
   try {
@@ -32,7 +55,6 @@ type AppMode = 'checking' | 'home';
 
 export default function App() {
   const [appMode, setAppMode] = useState<AppMode>('checking');
-  const [autoUpdateCheckEnabled, setAutoUpdateCheckEnabled] = useState(false);
   // 快速操作覆盖层：始终以 overlay 形式显示，不卸载 AppNavigator/HomeScreen
   const [shareReceiveOverlay, setShareReceiveOverlay] = useState(false);
   const [quickActionOverlay, setQuickActionOverlay] = useState<{
@@ -91,9 +113,6 @@ export default function App() {
         await runOverlayNetworkPreflight();
         // fg=1 完成后留在 app，fg=0/无fg 完成后退出
         setQuickActionOverlay({ direction, exitAfterSync: !fromForeground });
-      } else if (shouldEnableAutoUpdateCheck(url)) {
-        // URL 解析完成且不是 overlay 冷启动，才允许首页自动检查更新。
-        setAutoUpdateCheckEnabled(true);
       }
     });
 
@@ -123,9 +142,7 @@ export default function App() {
       <ThemeProvider>
         <I18nProvider>
           <ThemedStatusBar />
-          {appMode === 'checking' ? null : (
-            <AppNavigator autoUpdateCheckEnabled={autoUpdateCheckEnabled} />
-          )}
+          {appMode === 'checking' ? null : <AppNavigator />}
           {shareReceiveOverlay && (
             <View style={StyleSheet.absoluteFill}>
               <ShareReceiveScreen

src/__tests__/UpdateService.test.ts

@@ -150,4 +150,43 @@ describe('UpdateService', () => {
       assets: updateResult.assets,
     });
   });
+
+  it('命中缓存并启动安装器后清空可更新状态', async () => {
+    const dependencies = createDependencies({
+      checkCache: jest.fn(async () => 'file:///cached-update.apk'),
+    });
+    const service = new UpdateService(dependencies);
+    await service.checkForUpdates();
+
+    await expect(
+      service.installCachedUpdate(updateResult.latestVersion, updateResult.assets)
+    ).resolves.toBe(true);
+    expect(dependencies.install).toHaveBeenCalledWith('file:///cached-update.apk');
+    expect(service.getState()).toMatchObject({
+      updateAvailable: false,
+      latestVersion: null,
+      assets: [],
+      releaseNotes: undefined,
+    });
+  });
+
+  it('缓存安装器启动失败时保留可重试的更新状态', async () => {
+    const dependencies = createDependencies({
+      checkCache: jest.fn(async () => 'file:///cached-update.apk'),
+      install: jest.fn(async () => {
+        throw new Error('installer unavailable');
+      }),
+    });
+    const service = new UpdateService(dependencies);
+    await service.checkForUpdates();
+
+    await expect(
+      service.installCachedUpdate(updateResult.latestVersion, updateResult.assets)
+    ).rejects.toThrow('installer unavailable');
+    expect(service.getState()).toMatchObject({
+      updateAvailable: true,
+      latestVersion: updateResult.latestVersion,
+      assets: updateResult.assets,
+    });
+  });
 });

src/__tests__/appLaunch.test.ts

@@ -78,11 +78,7 @@ const SettingsStackNavigator = () => {
   );
 };
 
-interface AppNavigatorProps {
-  autoUpdateCheckEnabled: boolean;
-}
-
-export const AppNavigator = ({ autoUpdateCheckEnabled }: AppNavigatorProps) => {
+export const AppNavigator = () => {
   const { theme } = useTheme();
   const { t } = useTranslation();
 
@@ -151,9 +147,7 @@ export const AppNavigator = ({ autoUpdateCheckEnabled }: AppNavigatorProps) => {
           },
         })}
       >
-        <Tab.Screen name="Home" options={{ title: t('nav.home') }}>
-          {() => <HomeScreen autoUpdateCheckEnabled={autoUpdateCheckEnabled} />}
-        </Tab.Screen>
+        <Tab.Screen name="Home" component={HomeScreen} options={{ title: t('nav.home') }} />
         <Tab.Screen
           name="History"
           component={HistoryScreen}

src/navigation/AppNavigator.tsx

@@ -37,11 +37,7 @@ import { longRunningTaskManager } from '@/longRunningTask/LongRunningTaskManager
 import { updateService } from '@/services/update';
 import { useUpdateDialog } from '@/hooks/useUpdateDialog';
 
-interface HomeScreenProps {
-  autoUpdateCheckEnabled: boolean;
-}
-
-export function HomeScreen({ autoUpdateCheckEnabled }: HomeScreenProps) {
+export function HomeScreen() {
   const { theme } = useTheme();
   const { t } = useTranslation();
   const navigation = useNavigation();
@@ -72,7 +68,7 @@ export function HomeScreen({ autoUpdateCheckEnabled }: HomeScreenProps) {
 
   // 首页首次挂载后自动检查更新（默认每天一次）。
   useEffect(() => {
-    if (!isLoaded || !autoUpdateCheckEnabled) return;
+    if (!isLoaded) return;
     updateService
       .checkAutomatically()
       .then((result) => {
@@ -85,7 +81,7 @@ export function HomeScreen({ autoUpdateCheckEnabled }: HomeScreenProps) {
           console.warn('[HomeScreen] Auto update check failed:', error);
         }
       });
-  }, [autoUpdateCheckEnabled, isLoaded, showUpdateDialog]);
+  }, [isLoaded, showUpdateDialog]);
 
   // 启动所有后台任务（先加载字体，再启动后台任务，避免后台繁重任务导致导航栏图标加载缓慢）
   useEffect(() => {

src/screens/HomeScreen.tsx

@@ -159,6 +159,7 @@ export class UpdateService {
     if (!cached) return false;
 
     await this.dependencies.install(cached);
+    this.clearAvailableUpdate();
     return true;
   }
 
@@ -199,12 +200,7 @@ export class UpdateService {
       this.throwIfCancelled(abortController, this.downloadAbortController);
 
       await this.dependencies.install(fileUri);
-      this.setState({
-        updateAvailable: false,
-        latestVersion: null,
-        assets: [],
-        releaseNotes: undefined,
-      });
+      this.clearAvailableUpdate();
     } finally {
       if (this.downloadAbortController === abortController) {
         this.downloadAbortController = null;
@@ -239,6 +235,15 @@ export class UpdateService {
     return findAssetForAbi(assets, preferredAbi);
   }
 
+  private clearAvailableUpdate(): void {
+    this.setState({
+      updateAvailable: false,
+      latestVersion: null,
+      assets: [],
+      releaseNotes: undefined,
+    });
+  }
+
   private throwIfCancelled(
     controller: AbortController,
     activeController: AbortController | null