xmake-io / xmake-docs

The xmake online documentation site
https://xmake.io
49 stars 101 forks source link

document for manual installation on windows and custom installation on unix #37

Open xq114 opened 3 years ago

xq114 commented 3 years ago

注:如果是问题报障或者特性请求,请选择报告缺陷特性请求模板,否则一律不回复。

描述讨论详情

目前官网只有install by powershell/bash的instruction,以及unix环境local installation的instruction,没有windows上手动安装的instruction;(xmake-installer.exe缺少自动补全功能,需要手动安装)

unix环境的安装缺少自定义文件夹的instruction;无法选择script/binary安装到哪个文件夹。

waruqi commented 3 years ago

目前官网只有install by powershell/bash的instruction,以及unix环境local installation的instruction,没有windows上手动安装的instruction;(xmake-installer.exe缺少自动补全功能,需要手动安装)

自动补全目前也就 ps 脚本,手动装只能自己复制过去各种搞,很蛋疼的,除非高进 installer.nsi ,但目前还不支持,所以暂时没文档,可以自己看下ps的脚本实现。

不算自动补全,win下手动装,就是走 installer.exe 也没其他了,或者自己走 zip 包解压后自己加 path ,这个文档里也有提到。

unix环境的安装缺少自定义文件夹的instruction;无法选择script/binary安装到哪个文件夹。

目前不支持,也不建议自定义,否则 xmake update 可能不生效,文档里 make install PREFIX=/usr/local 编译安装可以指定,但是不支持 xmake update ,所以我也不推荐使用这种方式。。因此文档里我特意没写太多这块,就是为了不让用户自己这么搞。

xq114 commented 3 years ago

自动补全目前也就 ps 脚本,手动装只能自己复制过去各种搞,很蛋疼的,除非高进 installer.nsi ,但目前还不支持,所以暂时没文档,可以自己看下ps的脚本实现。

win上配置也可以放在脚本里啊,例如加一个参数./get.ps1 postinstall;另外linux上用包管理器安装,例如用apt安装,自动补全等也需要手动调用脚本配置,这些可以提供一个统一的说明

目前不支持,也不建议自定义,否则 xmake update 可能不生效,文档里 make install PREFIX=/usr/local 编译安装可以指定,但是不支持 xmake update ,所以我也不推荐使用这种方式。。因此文档里我特意没写太多这块,就是为了不让用户自己这么搞。

了解了;这个问题在windows上/linux包管理器安装的时候也存在吗?如果存在还是得在文档里说一下,不然从installer安装很容易装到别的位置

waruqi commented 3 years ago

了解了;这个问题在windows上/linux包管理器安装的时候也存在吗?如果存在还是得在文档里说一下,不然从installer安装很容易装到别的位置

win上不会,win上 xmake update 就是拉新的 installer 重新装一遍。。

win上配置也可以放在脚本里啊,例如加一个参数./get.ps1 postinstall;

走脚本,也是执行的 installer.exe 静默安装而已,没啥区别,而且脚本装主要就是对新手快速上手用的,也没必要提供各种复杂的参数设置,而且 ps 那个已经有 branch/version 参数了,再搞个参数 更复杂了,新手也搞不明白,还不如没有。

如果想自定义安装路径,自己下载 installer.exe 执行安装 原本就可以可视化修改安装路径。。

另外linux上用包管理器安装,例如用apt安装,自动补全等也需要手动调用脚本配置,这些可以提供一个统一的说明

目前也都不支持自动补全,所以也没有文档说明,apt 装的都是走的 make install,也都是不支持 xmake update 的,我原本也不太建议搞,虽然有 apt update 可以弄,但是自动补全要改打包脚本,暂时就不搞了。。

另外,自动补全这块也是人家帮忙贡献的,我也不太熟,deb,install.nsi 包如果也想支持,只能自己研究下 帮忙提个 pr 过来了。