learnX 诚招维护者

[Gravifer]

问题描述

robert 佬好，或许可以在readme里写一下会需要什么样的维护者，预期会需要多长时间之后接手项目之类的

[robertying]

同学你好，具体维护的工作范围是什么样还是取决于我和维护者之间的沟通协调。可以有多个维护者。

比如，如果某个维护者自身比较忙，那么通过提交 PR 修 bug 或者添加一些小 feature 参加；如果他们有余力，那么在沟通之后做大范围的代码重构或者界面修改，那也是可行的；如果有同学只是想加有且仅有一个新功能，然后跑路，那么我也欢迎。这也是为什么我没有直接写明；我还是想根据每个人的不同情况来。

那么这个维护者有啥特别的呢？我觉得特别之处在于我可以手把手教如何在本地把整个项目跑起来，从而让想要贡献的同学能够有个可行的起点。

目前在 App Store 上分发需要注册为开发者并且年付 $99 的订阅。这感觉也不是一笔小钱，所以我还是会作为主要开发者负责日常维护以及最终的打包、分发和上架。是否最终把完整的权限交给另一个同学，或者什么时候交，感觉是需要一段时间互动、考量和沟通的结果。

具体的技术要求就是前端经验，如果是 React 最佳，然后有 React Native 经验的话就完美了。主要还是看学习能力以及最后产生的 PR 吧。毕竟这也是个靠爱发电的项目，我尽我所能帮忙。

[hezicyan]

@robertying 请问您能否在项目中加一份部署指南？

[robertying]

@robertying 请问您能否在项目中加一份部署指南？

我之前想的是，把整个项目跑起来涉及到应用的证书以及一些私有的环境变量，所以直接基于 GitHub 版本跑起来不太可行。

不过我可以试试写写。

[robertying]

想了想我这边自己也弄不出来一个部署指南。因为我电脑上各种东西都配好了，所以很难知道如果在一个新的环境中哪些东西会缺失，会出现问题。感觉还是得有一个同学在自己环境里从头尝试，然后遇到什么问题罗列出来，一点点解决，这样大概能总结出一个指南来。

[hezicyan]

非常感谢！那我在这里反馈一下我部署中遇到的困难，本地机是 M3 芯片，Sonoma 14.6.1。

第一个困难是我在 pnpm start 后只有 run on iOS 和 run on Android 两个选项，请问我应该如何在 macOS 和 Windows 上运行？

然后我尝试了 run on iOS，遇到了 xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance 这个错误，StackOverflow 有解决方案。
之后成功跑起来了 iOS 模拟器，但也不知道下一步应该做什么了，我应该如何在这个模拟器中安装并测试 learnX 呢？

期间我有按照提示用 npx react-native doctor 确保了 iOS 部分的依赖都安装了。

我是第一次接触 Xcode，如果问题太蠢还请多多包涵 😢

[robertying]

@hezicyan

综合请参考 RN 的 doc：https://reactnative.dev/docs/set-up-your-environment

具体你的问题来说

• iOS 开发只能在 macOS 上进行，如果用 Windows 电脑的话只能构建 Android app。
• Xcode 包含 Xcode Command Line Tools 和 IDE，如果只是构建 app 的话，Command Line Tools 就够了，但是后期如果需要打包，IDE 提供了 GUI 还是很方便的。之前这个项目有设置 CICD，理论上不需要 Xcode，但我后来没搞了，所以现在打包上传还是得要 IDE 的 GUI 支持。你这个错误就是 Xcode 没装，或者 Xcode 装了之后没有打开过一次，把需要的依赖都装好。

以上两个我理解根据 doc 来设置应该不会有问题。

具体的 npm 命令

1. pnpm install 这个是装 node modules
2. pnpm pod 这个是把 node modules 里需要的 iOS 文件配置/安装好成 pods，pods 是 iOS 的包管理方式。这一步前置要求 cocoapods 装好了，参考 doc。这一步是跑 iOS 的前置，Android 不需要。
3. 你可以用 pnpm ios 来让 cli 构建+安装 app+运行 iOS 程序，同理 pnpm android 会跑 Android；你在 pnpm start 里做选择是一样的道理。pnpm start 的核心是 transpile 和打包 js 文件，然后这些 js 文件会在 app 里加载；pnpm ios 和 pnpm android 本质是 build 原生程序（Java/Swift/ObjC/ObjC++/C++）然后同时他们也会调用 pnpm start 的核心来确保 app 启动时能够加载 js 文件。

一些参数的例子：

• pnpm ios --simulator "iPhone 16 Pro" 不设定 simulator 的话默认会随便选一个模拟器打开，可能是那种屏幕小的 SE。
• pnpm android --mode release 把 release 版本装到当前目标里（默认是打开的 Android 模拟器，fallback 到当前连接的物理 Android 设备，这也可以通过参数修改目标）。release 版本把 js 完全打包好，不会动态加载 js 文件更改，不支持 hot reload，默认也会开 minification 和优化 etc。

Xcode 操作

上述的 pnpm ios 命令行大部分情况也可以直接通过 Xcode 里操作进行。在 Xcode 里选择 Run Target 为某个模拟器，或者真实设备比如你的 Mac（这时候就是 Mac Catalyst，iPad 应用跑在 Apple Silicon Mac 上），然后点 Run，他会构建 debug 版本然后安装。注意 Xcode 直接 Run 的话默认不会打开 JS 的 bundler，所以可以手动 pnpm start 然后 reload （模拟器 app 里或者 Terminal 里按 R）

在装完 pods 之后，在 Xcode 里打开 ios/learnX.xcworkspace 来加载项目。这里你可能就会遇到证书等问题了。这时候需要一个 Apple 账号注册了 Apple Developer（免费版本支持本地部署，只有上架才需要交 $99/yr）。登录 Developer 账号后 Xcode 应该会自动尝试创建证书，如果这里有问题可以贴，然后我们再尝试解决；目前我预计会出现 bundle identifier 相关的问题）

[hezicyan]

感谢回复！我现在能在 iOS 模拟器上正常运行了，但请问我应该如何跑 macOS 版的应用呢？

[robertying]

感谢回复！我现在能在 iOS 模拟器上正常运行了，但请问我应该如何跑 macOS 版的应用呢？

理论上通过 --device 应该能跑在 Mac 上，但是好像 cli 有个 bug。所以我现在都是 Xcode 选择 Run 到 My Mac (Mac Catalyst)。

[hezicyan]

在装完 pods 之后，在 Xcode 里打开 ios/learnX.xcworkspace 来加载项目。这里你可能就会遇到证书等问题了。这时候需要一个 Apple 账号注册了 Apple Developer（免费版本支持本地部署，只有上架才需要交 $99/yr）。登录 Developer 账号后 Xcode 应该会自动尝试创建证书，如果这里有问题可以贴，然后我们再尝试解决；目前我预计会出现 bundle identifier 相关的问题）

我似乎确实遇到证书问题了，我遇到了两个错误：

1. Cannot create a Mac Catalyst App Development provisioning profile for "io.robertying.learnX".
2. No profiles for 'io.robertying.learnX' were found

并没有在网上找到相关解决方案，但看起来和 bundle identifier 相关？

[robertying]

Xcode 里面 Signing & Capabilities 的 Team 都选了自己的 Apple 账号吗？要确保里面没有错误。

[hezicyan]

我觉得应该是的

learnX 的：

ShareExtension 的：

[robertying]

@hezicyan 你在那个页面把 Push Notification 给移除了试试，这个暂时也用不到

[hezicyan]

还是报错了 😢 不过提示词不一样了：

[robertying]

这样看的话，一个 bundle identifier 只能属于一个 team。

目前只是做本地开发的话可以改成你自己的，自己取一个就好。

[hezicyan]

我把 bundle identifier 和 App groups 都改掉之后就可以了！感谢回复！