《Cocos 游戏开发入门》17.2 多端发布：H5 / 微信小游戏 / 原生

location ~* \.(js|css|woff2|png|webp|mp3)$ {
  add_header Cache-Control "public, max-age=31536000, immutable";
  gzip on;
  gzip_types application/javascript text/css image/svg+xml;
}

location = /index.html {
  add_header Cache-Control "no-cache";
}

{
  "deviceOrientation": "landscape",
  "showStatusBar": false,
  "subpackages": [
    { "name": "levels-a", "root": "levels/a/" },
    { "name": "levels-b", "root": "levels/b/" }
  ]
}

// src/platform/wechat-subpackage.ts
interface SubPackageTask {
  onProgressUpdate(cb: (res: { progress: number }) => void): void;
}

interface WeChatApi {
  loadSubpackage(options: { name: string }, onDone: (err: unknown) => void): SubPackageTask;
}

function getWeChat(): WeChatApi | null {
  const g = globalThis as { wx?: WeChatApi };
  return g.wx ?? null;
}

export function loadPack(name: string, onProgress: (p: number) => void): Promise<void> {
  return new Promise((resolve, reject) => {
    const wx = getWeChat();
    if (!wx) {
      // 非微信环境（本地调试）直接放行，避免逻辑分叉
      resolve();
      return;
    }
    const task = wx.loadSubpackage({ name }, (err) => (err ? reject(err) : resolve()));
    task.onProgressUpdate((res) => onProgress(res.progress));
  });
}

// src/platform/detect.ts
interface WeChatApi {
  getStorageSync(key: string): string;
  setStorageSync(key: string, value: string): void;
  vibrateShort(options: { type: 'heavy' | 'medium' | 'light' }): void;
}

function getWeChat(): WeChatApi | null {
  const g = globalThis as { wx?: WeChatApi };
  return g.wx ?? null;
}

function hasAndroidBridge(): boolean {
  return typeof (globalThis as { AndroidBridge?: unknown }).AndroidBridge !== 'undefined';
}

export type PlatformName = 'h5' | 'wechat' | 'native';

export function detectPlatform(): PlatformName {
  if (getWeChat()) return 'wechat';
  if (hasAndroidBridge()) return 'native';
  return 'h5';
}

// src/platform/types.ts
export interface Storage {
  get(key: string): string | null;
  set(key: string, value: string): void;
}

export interface Platform {
  readonly name: PlatformName;
  readonly storage: Storage;
  vibrate(ms: number): void;
}

// src/platform/h5.ts
import type { Platform } from './types';

export function createH5Platform(): Platform {
  return {
    name: 'h5',
    storage: {
      get: (key) => globalThis.localStorage.getItem(key),
      set: (key, value) => globalThis.localStorage.setItem(key, value),
    },
    vibrate: (ms) => {
      // 浏览器振动 API，部分桌面浏览器不支持，静默忽略即可
      globalThis.navigator?.vibrate?.(ms);
    },
  };
}

// src/platform/wechat.ts
import type { Platform } from './types';

interface WeChatApi {
  getStorageSync(key: string): string;
  setStorageSync(key: string, value: string): void;
  vibrateShort(options: { type: 'heavy' | 'medium' | 'light' }): void;
}

export function createWeChatPlatform(wx: WeChatApi): Platform {
  return {
    name: 'wechat',
    storage: {
      get: (key) => wx.getStorageSync(key) || null,
      set: (key, value) => wx.setStorageSync(key, value),
    },
    // 小游戏只提供「短振动」，把毫秒数映射到强度档位
    vibrate: (ms) => wx.vibrateShort({ type: ms >= 40 ? 'heavy' : 'light' }),
  };
}

// src/platform/index.ts
import { detectPlatform } from './detect';
import { createH5Platform } from './h5';
import { createWeChatPlatform } from './wechat';
import type { Platform } from './types';

interface WeChatLike {
  getStorageSync(key: string): string;
  setStorageSync(key: string, value: string): void;
  vibrateShort(options: { type: 'heavy' | 'medium' | 'light' }): void;
}

let cached: Platform | null = null;

export function getPlatform(): Platform {
  if (cached) return cached;
  const wx = (globalThis as { wx?: WeChatLike }).wx;
  // 微信环境走小游戏实现；其余（含未桥接存储的原生）统一退回 H5 实现
  cached = detectPlatform() === 'wechat' && wx ? createWeChatPlatform(wx) : createH5Platform();
  return cached;
}