Skip to content

2659170494/CoCo_Cordova

Repository files navigation

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

您好,这是一个为一些编程猫的安卓发烧友准备的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),寻找绿色耀西(薄荷本兽)。
这样可以更快获得帮助!

About

CoCo Runtime to Cordova

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published