差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版		 前一修订版
manual:reference:toolchain:cspkg:main_page [2021/07/03 18:24] – [cspkg的使用] jolamanual:reference:toolchain:cspkg:main_page [2022/03/14 13:27] (当前版本) – mikecovlee
行 1: 行 1:
-===== 包管理器Cspkg =====+===== 包管理器 CSPKG =====
  
-//网址://+[[https://github.com/covscript/package-example|Package 示例: https://github.com/covscript/package-example]]
  
-[[https://github.com/covscript/package-example|package示例:https://github.com/covscript/package-example]] +[[https://covscript.org.cn/|CovScript官网: https://covscript.org.cn/]]   
- +
-[[https://covscript.org/|CovScript官网:https://covscript.org/]]    +
- +
-//目的://+
  
 ==== 更新环境 ==== ==== 更新环境 ====
行 13: 行 9:
 使用 cspkg 前，需要将 Covscript 更新至最新版：若是老版本，则利用 CovScript Installer 将原有的 Covscript 卸载(请一定要使用Installer卸载,否则下载新版本后会导致环境变量冲突); 使用 cspkg 前，需要将 Covscript 更新至最新版：若是老版本，则利用 CovScript Installer 将原有的 Covscript 卸载(请一定要使用Installer卸载,否则下载新版本后会导致环境变量冲突);
  
-打开官网[[https://covscript.org/|CovScript官网]],找到Windows x64(相对应的系统)的稳定版,并下载至本机。+打开官网 [[https://covscript.org.cn/|CovScript官网]], 找到Windows x64(相对应的系统)的稳定版, 并下载至本机。
  
-打开powershell 或 cmd 终端，输入 cs -v，若输出相关信息，则更新环境成功，可以开始尝试使用cspkg。+打开 powershell 或 cmd 终端，输入 cs -v，若输出相关信息，则更新环境成功，可以开始尝试使用cspkg。
  
 ==== cspkg的使用 ==== ==== cspkg的使用 ====
行 38: 行 34:
 可以先下载示例包，探索一下安装的过程。 可以先下载示例包，探索一下安装的过程。
  
-终端中使用 cspkg config source 与 cspkg list 查看本地所拥有的源(//source//)和包(//package//)。+终端中使用 ''cspkg config source'' 与 ''cspkg list'' 查看本地所拥有的源(//source//)和包(//package//)。
  
-使用 cspkg config source --app https://raw.githubusercontent.com/covscript/package-example/main/cspkg-source/index.json +使用<html><b> cspkg config source --app https://raw.githubusercontent.com/covscript/package-example/main/cspkg-source/index.json</b></html>添加测试源。
-添加测试源。+
  
-再使用 cspkg install testcse 下载指定的包，若搜索到该包，会将所有依赖列出，并请求确认。也可以加入参数 --yes 跳过确认。等待片刻，显示下载完成，即导入包成功。可再次使用cspkg list命令查看导入包信息。+再使用 ''cspkg install testcse'' 下载指定的包，若搜索到该包，会将所有依赖列出，并请求确认。也可以加入参数 <html><b>--yes</b></html> 跳过确认。等待片刻，显示下载完成，即导入包成功。可再次使用 ''cspkg list'' 命令查看导入包信息。
  
 **需要连接github下载相应的包。** **需要连接github下载相应的包。**
  
-==== 认识示例源代码 ====+----- 
 +\\ 
 + 
 +===== 封装并发布自己的包 ===== 
 + 
 +==== 认识示例源代码结构 ====
  
 我们提供了[[https://github.com/covscript/package-example|package示例]]，以使大家能照葫芦画瓢，更简单地使用该一功能。 我们提供了[[https://github.com/covscript/package-example|package示例]]，以使大家能照葫芦画瓢，更简单地使用该一功能。
行 89: 行 89:
 我们以无依赖的csp为例，封装一个只有输出''"hello my package"''的包： 我们以无依赖的csp为例，封装一个只有输出''"hello my package"''的包：
  
-建立一个文件夹，命名为**testPackage**，创建**my_package.csp** +建立一个文件夹，命名为**testPackage**，创建**my_package.csp**，创建 repo：my_package。
 <code matlab> <code matlab>
 package my_package package my_package
行 130: 行 129:
 </code> </code>
  
-在''windows_x86_64.json''中，输入以下内容：（复制粘贴即可）+在''universal.json''中，输入以下内容：（复制粘贴即可）
 <code json> <code json>
 { {
-    "my_package": "https://raw.githubusercontent.com/covscript/package-example/main/cspkg/testcsp.json"+    "my_package": "https://raw.githubusercontent.com/jin1xiao3long2/my_package/main/cspkg/my_package.json"
 } }
 </code> </code>
行 141: 行 140:
 全部操作完毕，此时repo里应有my_package.csp，cspkg-sourse文件夹。接下来便是将包挂载至github上。 全部操作完毕，此时repo里应有my_package.csp，cspkg-sourse文件夹。接下来便是将包挂载至github上。
  
-==== 在本地包装一个cse(参考c中源文件内容）====+==== 在本地包装一个cse ====
    
 我们以无依赖的cse为例，封装一个只有输出''"hello my package"''的包： 我们以无依赖的cse为例，封装一个只有输出''"hello my package"''的包：
行 240: 行 239:
 ==== 将包挂载在自己的github上 ==== ==== 将包挂载在自己的github上 ====
  
-将示例中的.github文件夹下载至本地，首先修改build.bat文件：+将示例中的''.github''文件夹下载至本地，首先修改''build.bat''文件：
  
 将最后一行中的： 将最后一行中的：
行 248: 行 247:
 </code> </code>
  
-将其中的covscript/package-example修改为注册的repo的地址。+将其中的''covscript/package-example''修改为注册的**repo**的地址。
  
 接下来修改 ''schechule.yml'': 接下来修改 ''schechule.yml'':
  
 <code yml> <code yml>
-on:schedual: - cron: ‘0 */ * * *’+on:schedual: - cron: ‘0 */4 * * *’
 </code> </code>
  
-为每四小时更新一次，可根据需要调整更新频率。+为每四小时更新一次，可根据需要调整更新频率(修改斜杠**/**后的数字)。
  
 首先找到 ''#Run tests'' 的注释，将后两个语句块删去**（以C:\build\bin\cs -i .\build .\run_test.csc）**结尾，关于测试的程序，在下一步再加入。 首先找到 ''#Run tests'' 的注释，将后两个语句块删去**（以C:\build\bin\cs -i .\build .\run_test.csc）**结尾，关于测试的程序，在下一步再加入。
行 282: 行 281:
  
 Csp文件： Csp文件：
- +<code> 
-Mypackage<<BR>> +Mypackage 
-|_.github<<BR>> +|_.github 
-  |_workflows<<BR>> +  |_workflows 
-    |_build.bat<<BR>> +    |_build.bat 
-    |_schedule.yml<<BR>>    +    |_schedule.yml   
-|_cspkg-source<<BR>> +|_cspkg-source 
-  |_index.json<<BR>> +  |_index.json 
-  |_universal.json<<BR>> +  |_universal.json 
-|_pacakge_name.csp<<BR>> +|_pacakge_name.csp 
-|_run_test.csc<<BR>> +|_run_test.csc 
 +</code>
  
 Cpp(cse)文件 Cpp(cse)文件
  
-Mypackage<<BR>> +<code> 
-|_.github<<BR>> +Mypackage 
-  |_workflows<<BR>> +|_.github 
-    |_build.bat<<BR>> +  |_workflows 
-    |_schedule.yml<<BR>>    +    |_build.bat 
-|_cspkg-source<<BR>> +    |_schedule.yml 
-  |_index.json<<BR>> +|_cspkg-source 
-  |_linux_x86_64.json<<BR>> +  |_index.json 
-  |_windows_x86_64.json<<BR>> +  |_linux_x86_64.json 
-|_pacakge_name.cpp<<BR>> +  |_windows_x86_64.json 
-|_package_name.json<<BR>> +|_pacakge_name.cpp 
-|_CMakeLists.txt<<BR>> +|_package_name.json 
-|_run_test.csc<<BR>>+|_CMakeLists.txt 
 +|_run_test.csc 
 +</code>
  
 ==== 测试 ==== ==== 测试 ====
行 322: 行 323:
  
 若我们想要在自己的服务器中导入多个包，则直接在repo添加新的包源码，重复同样的操作即可。当我们想要分享自己的包时，仅用将源分享给包使用者即可。 若我们想要在自己的服务器中导入多个包，则直接在repo添加新的包源码，重复同样的操作即可。当我们想要分享自己的包时，仅用将源分享给包使用者即可。
- 
-==== 原理 ==== 
  
  
-==== 目前的package包更新计划 ====