Readme.txt

!!!在您使用本项目之前,请看完本文档!!!

您好，这是一个为一些编程猫的安卓发烧友准备的CoCo转Cordova工程！
这个项目可能极不活跃，但一般有灵感了或者有时间了就会更新!

这个工程已经帮你把CoCo_Runtime所依赖的插件和环境配置好了。
您所需要做的就是准备好cordova、AndroidSDK和JAVA，
如果您已经安装好java,android sdk了，可以直接跳转到下一部分。
如果你是Linux且是Ubuntu，并且没有安装Java和android sdk的话,
可以在本目录执行这条命令进行安装啦：chmod 777 install-JDK-Android_SDK.sh && sudo bash install-JDK-Android_SDK.sh
但是！请不要将Android SDK安装在本项目的目录里！尤其是Codespace!!!
如果您将它安装在本项目目录且更改了默认路径且并没有添加进.gitignore，
这将导致您的Git卡死，Codespace奔溃无法启动且无法导出更改！！！
而且，这个脚本安装的SDK包会很大，所以个人比较推荐您参照notepad.txt给的教程进行手动安装。
当然您不嫌弃的话也行。安装完毕后会输出android sdk和java的路径。
并且在安装过程中脚本也会提示你一些事情，忘了或者没看到可以自己打开脚本文件查看。
之后执行export ANDROID_SDK_ROOT=<您的android sdk> && export ANDROID_HOME=<您的android sdk>
将<您的android sdk>替换成您本地安装的android sdk的路径。
如果您执行过上面的安装脚本，在脚本结束后脚本会有给出它们的路径。
JAVA_HOME同理，如果您缺少他，可以执行export JAVA_HOME=<您的JDK路径>。
同样上面的安装脚本有给出.

之后在上面java和android sdk的安装完毕后，
将coco打包的apk解压出来，把assets/www文件夹覆盖到本项目www文件夹。
并且删除www文件夹中的cordova.js、cordova_plugins.js、plugins和cordova-js-src.
之后回到项目根目录，
先执行npm install，安装本项目的包。
然后执行npm install cordova -g安装cordova到全局。
不要用npm i cordova 等之类的将cordova安装至项目！
那会破坏掉项目的node_modules和plugins!
如果您破坏了,请重新"git reset --hard"或克隆本项目一遍.
之后确认您的JDK版本为1.8之后,
执行cordova platform add android@9，
最后运行cordova build android编译apk即可。
当然，如果您想要编译最新版的android版本，
确认您的JDK版本为11以上(建议JDK17,本人仅在该版本下测试并开发)之后,
执行 cordova platform remove android
以及 cordova platform add android
最后 cordova platform update android

如果编译成功的话，说明您的项目配置已经成功了。
你可以i通过这个命令检查依赖配置： cordova requirements
之后您就可以基于本项目开发额外的扩展了，不过在开发之前记得检查一下项目目录的.gitignore
确认下里面没有你将要会使用的文件夹名字，因为如果它存在里面，那么文件夹和文件将不会被提交到git上。

如果您遇到插件上的问题,可以先"cordova platform remove android"
然后再重新安装一遍,大部分原因很可能是负责hook处理依赖的脚本没有被正确运行.

本项目主要针对于为Cordova-android@9以及cordova-android@13及以上的版本设计，
目标是想向上兼容的同时，可切换cordova-android版本向下兼容，如安卓8.0、6.0。
高版本也可以运行低版本cordova-android，不过有些插件和API（如全屏启动图）可能无法适用。
如需自定义请自行参考cordova教程本工程仅作为修改模板参考。

如果您要用ios项目的话,目前暂时适配的版本是:
Apple macOS@darwin
Xcode@14.2
cordova-ios@7.1.1
cocoapods@1.15.2
ios-deploy@1.12.2

一些编译上的问题,还有笔记以及注意事项,也可以查看同目录的notepad.txt哇。
也可以查看同目录中的hooks文件夹,那里面包含我对一些代码错误的一些修改脚本.
如有需要或者遇到问题，可以提交issue获得帮助！
或者加入编程猫CoCo编辑器QQ交流群(861247613)，寻找绿色耀西（薄荷本兽）。
这样可以更快获得帮助！