dispatch thunk of Alamofire.MultipartFormData.append(_: Foundation.Data, withName: Swift.String, fileName: Swift.String?, mimeType: Swift.String?) -> ()", referenced from:

先说工程结构
工程A有一个静态framework target a，通过cocoapods以源码方式集成了封装Alamofire，封装Alamofire的一些能力。

 workspace A
              |____ a (源码)
              |____Alamofire （源码）

构建输出静态framework a。

工程B有一个App Target，通过cocoapods以源码方式集成封装Alamofire，以静态库方式集成了 a。

 workspace B
             ｜___App
                      |____ a (静态库)
                      |____ Alamofire （源码）
 ```

 在同一电脑，用同一个Xcode，设置了相同的swift version，结果App构建失败，找不到Alamofire里的符号。

经过一番观察，发现 "dispatch thunk of Alamofire.MultipartFormData.append(...)"是 Swift 编译器为带有默认参数、可变签名或需要方法桥接的函数生成的“thunk”符号。也就是说静态库a引用了这些由 Alamofire 生成的编译器私有符号，但最终链接器没有在任何被链接的库/框架中找到对应实现。

 检查工程配置，首先排除Alamofire 的实现没有被链接到最终可执行文件（常见：静态库a引用但 App 没把 Alamofire 链接上）。

那么，最有可能的情况就是：工程B的Alamofire 与 工程A  使用不同的 Swift 编译环境/选项，导致 thunk 的名称/生成方式不一致，最终没有可匹配的符号。虽然Alamofire代码一摸一样，但是编译后的符号修饰方式不一样。

示意例子，例如同样是方法 test，
工程A中被修饰为 _$s12Alamofire4testtKF
工程B中被修饰为 $s12Alamofire4test_tKj

有了排查方向，经过对比工程A和工程B的配置，最终发现cocoapods自动生成target Alamofire的配置有些许不一致 

Build Libraries for Distribution 这个配置不一样，一个是YES，一个是NO。
又经实验，发现如果依赖Alamofire的target的 Build Libraries for Distribution 配置为YES，那么cocoapods自动生成的Alamofire对应的配置也是YES。

最后，只要将Alamofire对应Build Libraries for Distribution设置为NO（保持一致）就解决了Undefined symbols问题。

一般有两种解决办法：

一、如果这个framework不需要对外发布，那么将Build Setting里的Build Library For Distrubution 设置为NO，则可以继续使用桥接头文件(bridging-header)。

二、使用module map文件替换桥接头文件(bridging-header)，具体操作如下：

1、在framework工程里创建一个头文件，如Test.h
在Build Setting里设置User Header Search Paths，如$(SRCROOT)/$(PRODUCT_NAME)。设置的路径需要能找到Test.h文件

2、在Test.h文件里引入需要引用的Objective-C头文件

#import <MyLib/MyLib.h>

3、创建一个module map文件,module.modulemap，内容如下

module  TestModule (名字自定义)  {
    header "Test.h"
    export *
}

4、在Swift文件里，使用import指令，然后就可以调用Objective-C的方法了

import  TestModule

同时使用public 和 @objc标记

要给Objective-C暴露swift编写的api，则需要使用public 和 @objc标记

@objc public class MySwiftClass: NSObject {
    @objc public func doSomething() {
        print("Doing something in Swift")
    }
}

生成 Objective-C 兼容头文件

Swift Framework 的 Build Settings 中：

• Defines Module 设置为 YES。
• Install Generated Header 设置为 YES。
  这会生成一个 FrameworkName-Swift.h 头文件，包含 Swift 代码的 Objective-C 接口。

在 Objective-C 项目中导入导入 Swift Framework 的头文件

#import <FrameworkName/FrameworkName-Swift.h>

MySwiftClass *swiftObject = [[MySwiftClass alloc] init];
[swiftObject doSomething];

otool和install_name_tool

# 显示依赖库列表
otool -L  <mach-o文件路径>

# 添加新的依赖库路径
install_name_tool  -add_rpath  <rpath>   <mach-o文件路径>

# 删除依赖库路径
install_name_tool -delete_rpath  <rpath>  <mach-o文件路径>

# 替换依赖库路径
install_name_tool -change  <old_rpath>  <new_rpath>   <mach-o文件路径>

yololib 和ios App

对于iOS App，install_name_tool的-add_rpath、 -delete_rpath总是执行失败，需要借助yololib工具添加依赖

# 删除iOS App 的依赖
install_name_tool -change 需要删除的依赖   替换的空依赖 #变相实现删除

# 排序iOS App 的依赖
# 不断执行 install_name_tool -change  ，实现排序

https://forums.developer.apple.com/forums/thread/751049

libarchive源码 https://github.com/libarchive/libarchive/tree/v3.7.4

cmake工具手册
https://cmake.org/cmake/help/latest/manual/cmake-toolchains.7.html#cross-compiling-for-ios-tvos-visionos-or-watchos

基本操作

需要安装cmake（brew install cmake）

然后使用cmake为libarchive配置xcode工程

cd 源码目录
cmake -S. -B_builds -GXcode -DCMAKE_SYSTEM_NAME=iOS #结果输出到_builds文件夹

一般会遇到以下错误

CMake Error at cat/CMakeLists.txt:33 (INSTALL):
  INSTALL TARGETS given no BUNDLE DESTINATION for MACOSX_BUNDLE executable
  target "bsdcat".

CMake Error at tar/CMakeLists.txt:46 (INSTALL):
  INSTALL TARGETS given no BUNDLE DESTINATION for MACOSX_BUNDLE executable
  target "bsdtar".

CMake Error at cpio/CMakeLists.txt:42 (INSTALL):
  INSTALL TARGETS given no BUNDLE DESTINATION for MACOSX_BUNDLE executable
  target "bsdcpio".

CMake Error at unzip/CMakeLists.txt:37 (INSTALL):
  INSTALL TARGETS given no BUNDLE DESTINATION for MACOSX_BUNDLE executable
  target "bsdunzip".

以上错误的原因是iOS App并不支持MACOSX_BUNDLE，在CMakeLists.txt中注释对应的INSTALL动作就可以了

  例如对于bsdtar ,打开tar/CMakeLists.txt ，搜索以下两行，加上 # 注释
 # INSTALL(TARGETS bsdtar RUNTIME DESTINATION bin)
 # INSTALL_MAN(${bsdtar_MANS})

最后，删除输出文件夹（_builds文件夹），重新执行cmake命令

• Enable Multiple Windows 置为 YES
• 新建一个Scene配置（如果只有一个窗口，则不需要此操作）

判断当前环境是否支持多窗口

iOS13及以上支持多窗口；iPad设备和Vision设备支持，但iPhone不支持。

 if (@available(iOS 13.0, *))
{
    if (UIApplication.sharedApplication.supportsMultipleScenes)
    {// Info.plist也配置了多窗口开关

        if  (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad
            || UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomVision)
        {
            //支持多窗口
        }
    }
}

使用API创建新窗口

创建新的SceneDelegate

当App启用Scene后，需要使用Scene管理Window。为了管理新窗口，我们新建一个SceneDelegate

@interface SecondSceneDelegate : UIResponder < UIWindowSceneDelegate ,NSUserActivityDelegate>

@property (nonatomic,strong) UIWindow * window;

@end

@implementation SecondSceneDelegate
// 将要连接到某个场景（Window需要依附在具体场景）
- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions
{
    if (self.window == nil)
    {
        SecondSceneViewController *vc = [[SecondSceneViewController alloc] init]; // 自己定义的页面
        UINavigationController *naviVc = [[UINavigationController alloc] initWithRootViewController:vc];//页面导航
        self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
        self.window.windowScene = (UIWindowScene *)scene;
        self.window.rootViewController = naviVc;
        [self.window makeKeyAndVisible];
    }
}
@end

创建新窗口

使用requestSceneSessionActivation

NSUserActivity * activity = [[NSUserActivity alloc] initWithActivityType:@"open_by_first"];
[UIApplication.sharedApplication requestSceneSessionActivation:nil  //此参数为nil时，表示要求系统创建一个SceneSession
                                                  userActivity:activity
                                                       options:optios
                                                  errorHandler:^(NSError * _Nonnull error) {
    NSLog(@"%@",error);
}];

同时兼容iOS13及以上和iOS12及以下

请先去除工程中的StoryBoard的相关配置（否则，以下代码可能不会完全生效）。

在Info.plist中配置多窗口支持（参考上文）

略

修改AppDelegate

@interface AppDelegate : UIResponder <UIApplicationDelegate>

@property (nullable, nonatomic, strong) UIWindow *window; // 添加属性，注意这是UIApplicationDelegate的协议实现

@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    if (@available(iOS 13.0, *))
    { //iOS 13，启用Scene后，窗口在Scene的实现里创建
        return YES;
    }
    else
    {
        FirstSceneViewController *vc = [[FirstSceneViewController alloc] init]; // 自己定义的页面
        UINavigationController *naviVc = [[UINavigationController alloc] initWithRootViewController:vc];//页面导航
        self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
        self.window.rootViewController = naviVc;
        [self.window makeKeyAndVisible];
        return YES;
    }
}

- (UISceneConfiguration *)application:(UIApplication *)application configurationForConnectingSceneSession:(UISceneSession *)connectingSceneSession options:(UISceneConnectionOptions *)options 
{
    NSString *cfgName = @"FirstScene"; //场景名字
    if ([options.userActivities.objectEnumerator.nextObject.activityType isEqualToString:@"open_by_first"]) //使用哪个场景
    {
        cfgName = @"SecondScene";
    }
    return [[UISceneConfiguration alloc] initWithName:cfgName sessionRole:connectingSceneSession.role];
}
@end

创建（修改）SceneDelegate

为求简单，本文采用多组Window+SceneDelegate来管理多个窗口，即每个Window都有自己的SceneDelegate。本文实现了两个窗口的情形。

第一个SceneDelegate代码如下

@interface FirstSceneDelegate : UIResponder <UIWindowSceneDelegate>

@property (strong, nonatomic) UIWindow * window;

@end

@implementation FirstSceneDelegate

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions 
{
    session.userInfo = @{@"userData":@"first_session"};
    if (self.window == nil)
    {
        FirstSceneViewController *vc = [[FirstSceneViewController alloc] init]; // 自己定义的页面
        UINavigationController *naviVc = [[UINavigationController alloc] initWithRootViewController:vc];//页面导航
        self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
        self.window.windowScene = (UIWindowScene *)scene;
        self.window.rootViewController = naviVc;
        [self.window makeKeyAndVisible];
    }
}
@end

第二个SceneDelegate代码如下

@interface SecondSceneDelegate : UIResponder < UIWindowSceneDelegate ,NSUserActivityDelegate>

@property (nonatomic,strong) UIWindow * window;

@end

@implementation SecondSceneDelegate

// 将要连接到某个场景（Window需要依附在具体场景）
- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions
{
    session.userInfo = @{@"userData":@"second_session"};
    if (self.window == nil)
    {
        SecondSceneViewController *vc = [[SecondSceneViewController alloc] init]; // 自己定义的页面
        UINavigationController *naviVc = [[UINavigationController alloc] initWithRootViewController:vc];//页面导航
        self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
        self.window.windowScene = (UIWindowScene *)scene;
        self.window.rootViewController = naviVc;
        [self.window makeKeyAndVisible];
    }

}

@end

在第一个窗口的页面下，使用按钮打开第二个窗口

按钮事件响应

- (void)onClickButton:(id)sender
{
    if (@available(iOS 13.0, *))
    {
        if (UIApplication.sharedApplication.supportsMultipleScenes)
        {
            if  (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad
                 || UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomVision)
            {

                // 查找，确定是否已经打开过
                UISceneSession *foundSession = nil;
                NSString * foundStr = @"second_session";
                for (UISceneSession * session in UIApplication.sharedApplication.openSessions)
                {
                    if (session.userInfo && [foundStr isEqualToString:session.userInfo[@"userData"]])
                    {
                        foundSession = session;
                        break;
                    }
                }

                UISceneActivationRequestOptions *optios = nil;
                if (foundSession) // 已存在，激活即可
                {
                    [UIApplication.sharedApplication requestSceneSessionActivation:foundSession
                                                                      userActivity:nil
                                                                           options:optios
                                                                      errorHandler:^(NSError * _Nonnull error) {
                        NSLog(@"%@",error);
                    }];
                }
                else // 新建场景
                {
                    NSUserActivity * activity = [[NSUserActivity alloc] initWithActivityType:@"open_by_first"];
                    [UIApplication.sharedApplication requestSceneSessionActivation:nil 
                                                                      userActivity:activity
                                                                           options:optios
                                                                      errorHandler:^(NSError * _Nonnull error) {
                        NSLog(@"%@",error);
                    }];
                }
            }
        }
    }
}

其他注意事项

• 启用Scene后，UIAlertView将无法使用（运行时崩溃），需要用UIAlertController进行替换
• 在iPad端，实现多窗口时，需要将Info.list里的Requires full screen置为false，同时要设置为支持所有屏幕方向。否则可能会收到类似错误“the delegate of workspace fbscenemanger declined to create scene”
  

Build Phases -> Headers -> Project 

2、创建Bridge头文件，如 “TestBridging.h”，并填入头文件的相对路径

Build Settings -> Swift Compiler General -> Objective-C Bridging Header -> xxxx/TestBridging.h

3、在Bridge头文件中引用Objective-C头文件 （不用使用<>形式引用）

// TestBridging.h

#import "A.h"
#import "B.h"
#import "C.h"

4、关闭 defines Module

Build Settings -> Packaging -> Defines Module -> No

本文涉及三点：

• @resultBuilder
• 可变参数
• 闭包以及尾随闭包

我们可以自己定义一个类似@ViewBuilder的注解，本文将实现一个自定义的字符串拼接的注解。

首先 用 @resultBuilder修饰的 struct符号需要实现静态buildBlock方法

@resultBuilder public struct TestStringBuilder {
    public static func buildBlock( s1 : String ,s2 : String) -> String {
        return s1 + s2
    }
}

然后定义一个函数，只有一个闭包参数，参数使用@TestStringBuilder修饰

func  test_string_builder(@TestStringBuilder strs_join: () -> String ) {
    print(strs_join())
}

现在可以给test_string_builder传入闭包参数了

test_string_builder( strs_join :{
    "a"
    "b"
})

//将打印字符串 “ab”

该尾随闭包出场了，它是一个书写在函数括号之后的闭包表达式，函数支持将其作为最后一个参数调用

test_string_builder(){
    "a"
    "b"
}

//将打印字符串 “ab”

如果函数只需要闭包表达式一个参数，当您使用尾随闭包时，可以把()省略掉

test_string_builder{
    "a"
    "b"
}

//将打印字符串 “ab”

现在是不是有点像@ViewBuilder的用法了？最后是可变参数，修改下buildBlock定义，以支持可变参数

@resultBuilder public struct TestStringBuilder {
    public static func buildBlock(_ strs: String...) -> String {
        var ret = ""
        for s in strs {
            ret = ret + s
        }
        return ret
    }
}

最终test_string_builder的用法

test_string_builder {
    "a"
    "b"
    "c"
    "d"
}

//将打印字符串 “abcd”

@ViewBuilder的原理和上面类似。

吐槽下，编译器做了很多事，以至于让人习惯语法糖后忘记了该有的本来面目。

https://developer.apple.com/forums/thread/711730