在过去的几年里ExpoYi经从「只会跑 Demo」进化成企业级交付的利器。可是一提到原生功Neng——尤其是微信这类社交 SDK——hen多人仍然觉得「在 Expo 中根本弄不来」。今天我把自己在真实项目里踩过的坑、写过的代码全部搬出来帮你在 expo‑managed 环境下顺利完成「分享到微信」这件事。

登录 ，新建「移动应用」并记录下生成的 AppID。

填写 iOS 端信息：

Bundle ID：com.yourcompany.yourapp

Universal Link：https://yourdomain.com/open/

Android 那边直接填包名即可，后面会在 Manifest 中自动注入对应 Activity。

Team ID：形如 A1B2C3D4E5

Bundle Identifier：必须和上一步骤保持一致。

开启「Associated Domains」Neng力，添加域名：applinks:yourdomain.com

react-native-wechat-lib 本身是原生模块，在纯 Expo 项目里直接引用会报错。我们需要写一个小插件，让构建工具在打包时自动往 Info.plist 与 AndroidManifest 注入必要字段。

// plugins/withWechat.js
const { withInfoPlist, withAndroidManifest } = require;
function withWechat {
  if  {
    throw new Error;
  }
  // ---------- iOS ----------
  config = withInfoPlist => {
    // URL Scheme
    const urlTypes = cfg.modResults.CFBundleURLTypes || ;
    const scheme = { CFBundleURLSchemes: , CFBundleURLName: 'wechat' };
    if )) {
      urlTypes.push;
    }
    cfg.modResults.CFBundleURLTypes = urlTypes;
    // LSApplicationQueriesSchemes
    const queries = cfg.modResults.LSApplicationQueriesSchemes || ;
    .forEach(s => {
      if ) queries.push;
    });
    cfg.modResults.LSApplicationQueriesSchemes = queries;
    return cfg;
  });
  // ---------- Android ----------
  config = withAndroidManifest => {
    const manifest = cfg.modResults.manifest;
    const application = manifest.application?.;
    if  return cfg;
    const pkg = config.android?.package ?? 'com.yourapp';
    const entryName = `${pkg}.wxapi.WXEntryActivity`;
    // 确保 WXEntryActivity Yi经写进去
    if ) {
      application.activity = ;
      manifest.application = application;
      cfg.modResults.manifest = manifest;
      console.log;
    }
   return cfg;
  });
  return config;
}
module.exports = withWechat;

⚠️ 注意：这里没有使用 `pod install`，EAS Build 会自行处理 iOS 原生依赖。

// app.config.js
module.exports = {
  expo: {
    name: "MyAwesomeApp",
    slug: "my-awesome-app",
    // 把 AppID 暴露给业务代码
    extra: { wechatAppId: "wx1234567890abcdef" },
    ios: {
      bundleIdentifier: "com.yourcompany.myawesomeapp",
      associatedDomains:,
      infoPlist:{
        LSApplicationQueriesSchemes:
      }
    },
    android:{
      package:"com.yourcompany.myawesomeapp"
    },
    plugins:
    ]
  }
};

AOP 思想：所有与微信 SDK 的交互，dou走同一个单例对象。这样以后想换库或者加日志，只改这里就行了。

// src/services/wechatService.ts
import { Platform, Alert } from "react-native";
import Constants from "expo-constants";
const APP_ID = Constants.expoConfig?.extra?.wechatAppId ?? "";
let WeChat:any=null;
let triedLoad=false;
function loadSDK{
    if return WeChat;
    triedLoad=true;
    if return null;
    try{
        const mod=require;
        WeChat=mod.default||mod;
    }catch{
        console.warn;
    }
    return WeChat;
}
class WechatService{
    private registered=false;
    isSupported{
        if return false;
        const sdk=loadSDK;
        return !!sdk && typeof sdk.registerApp==="function";
    }
    async register{
        if return true;
        const sdk=loadSDK;
        if return false;
        try{
            const ok=await sdk.registerApp;
            this.registered=ok;
            return ok;
        }catch{
            console.error;
            return false;
        }
    }
    async isInstalled{
        const sdk=loadSDK;
        if return false;
        try{
            return await sdk.isWXAppInstalled;
        }catch{
            return false;
        }
   }
   async shareWeb({title,description,thumbImageUrl="",webpageUrl,scene="session"}:{
       title:string;description:string;thumbImageUrl?:string;webpageUrl:string;scene?:'session'|'timeline'|'favorite';
   }){
       if){
           return {success:false,message:"当前环境不支持微信分享"};
       }
       const reg=await this.register;
       if return {success:false,message:"微信 SDK 初始化失败"};
       const installed=await this.isInstalled;
       if return {success:false,message:"请先安装微信客户端"};
       const sceneMap={session:'session',timeline:'timeline',favorite:'favorite'};
       const sdk=loadSDK;
       try{
           await sdk.shareWebpage({
               title,
               description,
               thumbImageUrl,
               webpageUrl,
               scene:sceneMap,
           });
           return {success:true,message:"Yi成功分享到微信"};
       }catch{
           if return {success:false,message:"用户取消分享"};
           return {success:false,message:e.message||"未知错误"};
       }
   }
   // 图片分享示例
   async shareImage({imageUrl="",imageBase64="",scene='session'}:{
       imageUrl?:string;imageBase64?:string;scene?:'session'|'timeline'|'favorite';
   }){
       if)return{success:false,message:"不支持"};
       await this.register;
       if))return{success:false,message:"未检测到微信"};
       const sdk=loadSDK;
       const map={session:'session',timeline:'timeline',favorite:'favorite'};
       try{
           await sdk.shareImage({
               imageUrl:imageBase64||imageUrl,
               scene:map,
           });
           return {success:true,message:"图片Yi发送"};
       }catch{
           return {success:false,message:e.message||"图片发送失败"};
       }
   }
}
export const wechatService=new WechatService;

a）在域名根目录放置 Apple 要求的 JSON 文件：

{
  "applinks": {
     "apps": ,
     "details": ,
           "components": 
         }
     ]
  },
  "webcredentials": {"apps":}
}

b）Nginx 示例：

location /.well-known/apple-app-site-association {
   default_type application/json;
   alias /var/www/yourdomain/.well-known/apple-app-site-association;
}

// components/ShareButton.tsx
import React from "react";
import { Button, Alert } from "react-native";
import { wechatService } from "@/services/wechatService";
export function ShareButton {
  const handlePress = async  => {
     const result = await wechatService.shareWeb({
         title:"《2026 趋势报告》抢先kan",
         description:"这是一篇关于未来技术趋势的深度文章，快来一起阅读吧！",
         thumbImageUrl:"https://example.com/thumb.png",
         webpageUrl:"https://example.com/report2026.html",
         scene:"timeline",               // 改成 session 就是好友聊天框
     });
     Alert.alert;
  };
  return ;
}

把这个组件塞进任何页面douNeng立刻拥有「一键分享到朋友圈」的Neng力。

EAS Build iOS:

eas build -p ios --profile production
# 若想直接推送 TestFlight：
eas build -p ios --profile production --auto-submit

EAS Build Android：

eas build -p android --profile production
# 完成后下载 .apk 或 .aab 安装测试

*关键提醒*: 在 Expo Go 中打开项目是kan不到任何分享按钮响应的，因为那只是 JavaScript 环境，没有链接到 native SDK。一定要使用 EAS 打出来的独立包进行验证。

*重启手机*: 第一次上线 Universal Link 后iOS 系统会缓存关联域名。若发现点击后没有跳转，请尝试重启设备再测试。

*校验链接*: 在浏览器访问 https://apple-app-site-association.cdn-apple.com/a/v1/yourdomain.com/.well-known/apple-app-site-association. 返回 JSON 表示 Apple Yi经成功抓取你的文件。

💡"DEBUG_MODE": 在服务层打开全局开关，即可弹出每一步关键状态，让你快速定位是哪一步卡住了。

💻"Logcat"/"Console": 安卓Ke以用 `adb logcat | grep WeChat` 查kan原生日志；iOS 用 XCode 的 Console 同理。

⚠️"重新注册": 每次启动前dou调用一次 `register`，防止用户切换账号导致 token 丢失。

把「分享到微信」这根kan似细碎却极具商业价值的链子嵌进你的 Expo 项目，并不是一句「npm install + import」就Neng搞定。它牵涉到平台账号备案、原生配置注入、Universal Link 的服务器支撑以及对不同系统差异化处理。但只要遵循上面这套思路，你只需要维护一段简洁的业务代码，就Neng让用户随时将内容抛向朋友圈或私聊窗口，从而极大提升产品曝光率和转化率。

祝你玩得开心，也欢迎在评论区留下你的踩坑经验或改进建议，我们一起让 Expo + 微信组合变得geng强大！ 🚀🚀🚀