新手教程

[Meieryang]

自己慢慢摸索终于把软件装起来开始用了。为了感谢作者的辛苦付出，让生态更好的发展，暂且写一个新手教程来帮助第一次接触这个项目的朋友，希望这个教程可以缩短你摸索的时间。请求作者不要关闭这个issue。

1. 首先主分支不是master，请先把分支切换到meta，那个才是活跃的分支，原因dddd。
2. 然后把meta分支的项目克隆到你的电脑上，最好直接克隆到你的Xcode用来存项目的文件夹里，方便管理。
3. 现在你的项目文件夹名称叫 “ClashX.Meta” ,当前文件夹里面有 “ClashX”文件夹和“install_dependency.sh”文件，还有很多其他文件，请先确认好。
4. 接下来用Xcode打开“ClashX.Meta”整个项目，然后他会自动下载很多和Swift相关的依赖包，等待全都下好，然后点运行，这时候会显示报错，提示缺少一些依赖文件，这是正常的，因为还没有安装外部依赖。
5. 外部依赖就是通过“install_dependency.sh”文件来安装的。接下来我们浏览一下这个shell文件。（先不要运行）
6. 首先来看，第一个操作是cd clash.meta
cd 是一个bash命令，作用是切换当前所在的目录 (Change Directory) ，但是我们这个项目中其实并没有"clash.meta"这个文件夹。
7. 现在要在项目的目录下新建一个名为"clash.meta"的文件夹。其实这个是clash.meta的核心文件，现在已经改名mihomo。
8. 从官网 https://wiki.metacubex.one/startup/#__tabbed_8_2 《虚空终端Docs》的“安装“选项卡中，根据你的系统选择一个预编译的二进制文件下载，然后放在你刚刚创建的"clash.meta"文件夹里。我的电脑是M1芯片的MacBook Air，我选择的是“mihomo-darwin-arm64-alpha-846bdfa.gz”这个文件，仅供参考。
9. 现在再运行“install_dependency.sh”文件，遇到的下一个可能的报错是这行命令：
   lipo -create -output com.metacubex.ClashX.ProxyConfigHelper.meta mihomo-darwin-amd64* mihomo-darwin-arm64*
   简单来说lipo命令是用来转换并打包文件的。仔细观察这段代码，问题发生的关键是mihomo-darwin-amd64* 或 mihomo-darwin-arm64*。我们刚才根据我们自己的系统架构下载文件，并没有下载其他系统架构的文件。我的是M1芯片的电脑，所以我下载的是开头为mihomo-darwin-arm64 的文件，很显然前面那个amd64我刚才没有下载，在这里也是多余的，用不到的，所以我删除了mihomo-darwin-amd64*字段，这段命令就可以正常运行了。你需要根据你自己的文件来决定删除哪一个。
10. 接下来可能遇到的问题是使用curl命令下载github的文件时连接失败或者速度慢，这个已经轻车熟路了，转到 "~/.zshrc"文件，在文件中添加这两行就行了。

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

如果你用的不是clash for Windows，记得改一下端口号。
如果你实在用不来用命令行下载库依赖，也别折磨自己了。你可以用浏览器打开curl的链接，然后文件就下载好了，把文件放进项目的文件夹下（不是你自己新建的clash.meta！是ClashX.meta!!!）,再把shell文件里的curl命令都删了就行了。
11. 在安装依赖的时候肯定会遇到很多问题，这是正常的，保持耐心。你可以通过echo命令打印出的信息来判断哪些命令已经成功执行了。在每一次执行失败后，你可以将已经执行成功的命令用#号注释掉，这样就不会由于重复执行导致的混乱。
12. 现在我们已经成功完成了所有依赖的安装，此时我们可以在Xcode中运行程序了。但是在Xcode中运行似乎不能正常使用软件，我们需要将应用导出才能正常使用。
13. 最正式的做法是点击菜单栏中的 Product > Archive，然后对应用进行签名然后导出，但是这样导出需要你开通Apple Developer Program，每年99美刀我是付不起的，所以我是这么做的：
1） 构建项目：
* 在 Xcode 中，选择 Product > Build 进行构建。
2） 找到构建的 .app 文件：
* 在 Finder 中，导航到 ~/Library(资源库)/Developer/Xcode/DerivedData。
* 找到你的项目文件夹，然后进入 Build/Products/Release 目录。
* 找到你的 .app 文件。
3） 移动 .app 文件到 应用程序 目录：
* 将 .app 文件拖动到 /Applications 文件夹。
4） 运行应用：
* 双击 .app 文件运行应用。
* 如果遇到安全提示，可以按如下步骤操作：
* 打开 系统偏好设置 > 安全性与隐私 > 通用。
* 点击 允许 或 仍要打开。
* 如果显示“文件损坏，它应该被移到废纸篓”：
* 这是因为我们没有对其进行签名导致的，高版本的MacOS在面对没有签名的应用程序会这样显示，我们只需要在系统设置中将允许的应用程序更改到“任何来源”即可。
* 打开终端，输入 sudo spctl --master-disable,重启应用即可。

这样就可以在不加入 Apple Developer Program 的情况下，将应用安装到自己的Mac。
14. 现在我们可以正常运行程序了。单击任务栏中的"M"图标，在弹出的菜单中选择 配置 > 托管配置 > 管理。随后将你的订阅地址添加进去，等待更新完成，关闭窗口即可使用！
15. 最后感谢一下chatGPT的鼎力支持，他的耐心协助才帮助我成功用上了这么好用的软件！
如果你遇到了什么问题，也可以在下面留言，我会尽力帮助！

[thenewone314]

打开clash之后有一个“com.metacubex.ClashX.ProxyConfigHelper.meta”的进程疯狂消耗流量是为什么您知道吗