Skip to content

Latest commit

 

History

History
150 lines (115 loc) · 6.95 KB

README.md

File metadata and controls

150 lines (115 loc) · 6.95 KB
Raw

FinClipWeChatExtSDK-iOS

FinClip iOS DEMO

本项目提供在 iOS 环境中接入凡泰定制的用于提供小程序部分微信SDK能力的示例

👉 https://www.finclip.com/ 👈

🤔 FinClip 是什么?

有没有想过，开发好的微信小程序能放在自己的 APP 里直接运行，只需要开发一次小程序，就能在不同的应用中打开它，是不是很不可思议？

有没有试过，在自己的 APP 中引入一个 SDK ，应用中不仅可以打开小程序，还能自定义小程序接口，修改小程序样式，是不是觉得更不可思议？

这就是 FinClip ，就是有这么多不可思议！

1.1 微信扩展SDK

微信SDK的快捷接入，提供调起微信通过微信小程序获得登录、用户信息、手机号、支付的能力。 快捷集成方式：

pod 'FinAppletWXExt'

::: tip 注意 在使用FinAppletWXExt时，需要按照 微信接入指南-iOS 接入指南 进行配置，具体有如下内容：

  1. 配置应用的Universal Links；
  2. 打开Associated Domains开关，将Universal Links域名加到配置上；
  3. 在工程的Target -> 【Info】 -> 【URL Types】，新增一个URL Schemes（key为weixin，value为wx+在微信申请的Appid）；
  4. 在工程info.plist中增加应用访问白名单LSApplicationQueriesSchemes，对应的要填写的值为wechat，weixin，weixinULAPI。记得在苹果开发者中心App ID Configuration处勾选Associated Domains。 :::

进行初始化注册组件：

// 微信扩展SDL初始化
[FATWXExtComponent registerComponent:@"微信appid" universalLink:@"universalLink"];

并在AppDelegate.m中增加下面的代码。

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    /*  微信登录和分享    */
    if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) {
        return YES;
    }
    return YES;
}

// iOS 9.0 之前
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
    /*  微信登录和分享    */
    // `WeChatHandleURLDelegate ` 为 `WXApiDelegate`代理文件
    if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) {
        return YES;
    }
    return YES;
}

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
    /*  微信登录和分享    */
    if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) {
        return YES;
    }
    return YES;
}

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
  return [WXApi handleOpenUniversalLink:userActivity delegate:[FATWXApiManager sharedManager]];
}

::: tip 注意 使用微信扩展SDK必须保证核心SDK版本在2.37.13或以上。 :::

::: tip 注意 由于FinAppletWXExt需要覆盖buttonOpenTypeDelegate（2.37.13前的版本为FATAppletDelegate）中的open-type相关的方法，具体为chooseAvatar、contact、feedback、getPhoneNumber、launchApp、shareAppMessage六个方法。 因此若您实现了buttonOpenTypeDelegate并实现了以上六个方法，FinAppletWXExt将会接管getPhoneNumber，剩余的五个方法请按以下方式迁移，若您未实现buttonOpenTypeDelegate或没有用到以上六个方法，可以忽略此处,若是既需要集成FinAppletWXExt又需要实现open-type相关的方法，则参考下边的说明。 1.在核心SDK和微信扩展SDK初始化成功后，设置您的代理方法实现类

[FATDelegateClientHelper sharedHelper].buttonOpenTypeDelegate = [FINWXButtonDelegate sharedHelper];

2.实现buttonOpenTypeDelegate的代理方法

- (BOOL)forwardAppletWithInfo:(NSDictionary *)contentInfo completion:(void (^)(FATExtensionCode code, NSDictionary *result))completion {
    return YES;
}

- (BOOL)getUserInfoWithAppletInfo:(FATAppletInfo *)appletInfo bindGetUserInfo:(void (^)(NSDictionary *result))bindGetUserInfo {
    return YES;
}

- (BOOL)contactWithAppletInfo:(FATAppletInfo *)appletInfo sessionFrom:(NSString *)sessionFrom sendMessageTitle:(NSString *)sendMessageTitle sendMessagePath:(NSString *)sendMessagePath sendMessageImg:(NSString *)sendMessageImg showMessageCard:(BOOL)showMessageCard {
    return YES;
}

- (BOOL)getPhoneNumberWithAppletInfo:(FATAppletInfo *)appletInfo bindGetPhoneNumber:(void (^)(NSDictionary *result))bindGetPhoneNumber {
    NSLog(@"小程序信息:%@", appletInfo);
    return YES;
}

- (BOOL)launchAppWithAppletInfo:(FATAppletInfo *)appletInfo appParameter:(NSString *)appParameter bindError:(void (^)(NSDictionary *result))bindError bindLaunchApp:(void (^)(NSDictionary *result))bindLaunchApp {
    return YES;
}

- (BOOL)feedbackWithAppletInfo:(FATAppletInfo *)appletInfo {
    return YES;
}

- (BOOL)chooseAvatarWithAppletInfo:(FATAppletInfo *)appletInfo bindChooseAvatar:(void (^)(NSDictionary *result))bindChooseAvatar {
    return YES;
}

:::