xdk cli
1.0.0
Échafaudage cli de l'applet WeChat. L'auteur est généralement un peu occupé. Si des étudiants sont intéressés par ce projet, ils peuvent le maintenir et le développer ensemble.
Actuellement fourni :
Remarque : les instructions personnalisées peuvent être utilisées avec les hooks de publication pour effectuer des choses plus intéressantes, telles que modifier les variables d'environnement dans le fichier de configuration ci-dessous, soumettre des validations de version , etc.
Si vous le trouvez utile, j'espère que vous pourrez lui donner une étoile~ ???
Installer globalement en utilisant npm
npm install -g xdk-cliUne fois l'installation réussie, vous pouvez l'utiliser pour afficher le numéro de version actuel.
xdk-cli -vUtilisez -h pour afficher l'introduction des fonctionnalités actuellement fournies
xdk-cli -h # 目录结构
- app(小程序目录)
- pages
- app.js
- app.json
- project.config.json
- template
- page
- page.js
- page.json
- page.wxml
- page.wxss
- component
- component.js
...
- xdk.config.js
- xdk.verison.json
# xdk.config.js 设置
module.exports = {
entry: './app'
}
# 目录结构
- dist
- src(小程序目录)
- pages
- app.js
- app.json
- project.config.json
- template
- page
...
- component
...
- xdk.config.js
- xdk.verison.json
# xdk.config.js 设置
module.exports = {
entry: './src',
output: './dist'
}
xdk.config.js doit être créé dans le répertoire du projet
module.exports = {
// 小程序路径(可选，默认当前目录)
entry: './src',
// 小程序输出文件(可选，默认等于entry)
// 使用gulp，webpack等打包工具开发会导致开发者编辑文件目录和微信编辑器使用目录不同，需要手动进行指定
output: './dist'
// 模版文件夹目录(可选，默认使用cli默认模版，使用默认模版情况下false即可)
template: './template',
// 发布体验版功能的钩子
publishHook: {
// 发布之前（注：必须返回一个Promise对象）
// 参数answer 为之前回答一系列问题的结果
before(answer) {
this.spawnSync('gulp', [`--env=${answer.isRelease ?'online' : 'stage'}`]);
return Promise.resolve();
},
// 发布之后（注：必须返回一个Promise对象）
after(answer) {
// 是否提交git commit
let {isCommitGitLog} = await inquirerGitCommit.call(this);
// 当为正式版本时进行的操作
if (!!answer.isRelease) {
// 修改本地version code
await rewriteVersionCode.call(this);
// 提交git log
!!isCommitGitLog && await commitGitLog.call(this);
}
return Promise.resolve();
}
},
// 自定义命令
// 自定义指令需要用 run 来执行，例如 xdk-cli run dev
customScripts: [
{
name: 'dev',
desc: '开发模式',
async callback() {
let {env} = await inquirerEnvAsync.call(this);
this.spawn('gulp', [`--env=${env}`, '--watch']);
return Promise.resolve();
}
},
{
name: 'sassDoc',
desc: '生成sass文档',
async callback() {
// 生成文档
await sassdoc([`./src/stylesheets/**/*.scss`, `./src/stylesheets/*.scss`], {
dest: './sassdoc',
verbose: true,
display: {
access: ['public'],
alias: true,
},
autofill: ["requires", "throws", "content"],
});
// 自动打开文件
if (process.platform === 'darwin'){
this.spawnSync('open', [`./sassdoc/index.html`]);
}else {
this.log(`目前自动打开浏览器功能只支持darwin内核, 当前内核为: ${process.platform}`);
this.log(`请打开当前路径下html，路径：./sassdoc/index.html`);
}
return Promise.resolve();
}
}
],
};
// 询问是否提交git记录
function inquirerGitCommit() {
return this.inquirer.prompt([
{
type: 'confirm',
name: 'isCommitGitLog',
message: '是否提交git log ?'
}
])
}
// 提交git commit 到log
function commitGitLog() {
return new Promise((resolve, reject) => {
this.spawnSync('git', ['add', '.']);
this.spawnSync('git', ['commit', '-m', `docs: 更改版本号为${versionConf.version}`]);
resolve();
});
}
Fournit la fonction d'identifier automatiquement les sous-contrats et les pages et de les ajouter à app.json, ${page}.json
# 输入创建命令
xdk-cli create
# 选择创建模式
? 选择你想生成的模版类型：(Use arrow keys)
❯ page
component # 输入页面名称
? 设置 page 的名字 (例如: index):
# 选择所属分包（none为主包）
? 设置页面所属的分包 (Use arrow keys or type to search)
# 创建成功
>> createPage success # 输入组件名称
? 设置 component 的名字 (例如: swiper-card):
# 选择组件所属范围
? 设置组件所属的作用域 (Use arrow keys)
❯ global
module
page
# 选择所属页面/分包/全局范围
？设置组件所属的页面
❯ index
logs
user
# 创建成功
>> createComponent successChaque projet peut nécessiter différents modèles. xdk-cli fournit un emplacement de dossier pour faciliter la personnalisation des modèles que vous devez utiliser.
// 在xcli.config.js 中配置模版目录
module . exports = {
// 模版文件夹
template : './template'
} ;Pour plus de détails sur la structure des répertoires du mini-programme, voir [ Structure du répertoire du projet ] ci-dessus.
Actuellement, seule la version mac est prise en charge. L'auteur ne dispose pas d'un environnement de développement Windows (relativement paresseux pour en ajouter plus).
{
"version" : " 0.1.9 " ,
"versionDesc" : "版本描述"
}xdk-cli publish # 正式版本会修改本地的xdk.config.json文件, 非正式版本不会，且体验版版本号默认为0.0.0
? 是否为正式发布版本? Yes
# 设置版本号
? 设置上传的版本号 (当前版本号: 0.1.9.4): raise alter: 0.1.9
# 设置版本描述
? 写一个简单的介绍来描述这个版本的改动过: 提交了一个正式版
Initializing...
idePortFile: /Users/xuan/Library/Application Support/微信开发者工具/Default/.ide
IDE server has started, listening on http://127.0.0.1:27563
initialization finished
uploading project...
upload success
>> 上传体验版成功, 登录微信公众平台 https://mp.weixin.qq.com 获取体验版二维码en cas d'échec
xdk.config.js Effectuer les réglages publishHook : {
// 发布之前（注：必须返回一个Promise对象）
before ( answer ) {
console . log ( '要开始发布了' ) ;
return Promise . resolve ( ) ;
} ,
// 发布之后（注：必须返回一个Promise对象）
after ( answer ) {
console . log ( '发布结束了' ) ;
return Promise . resolve ( ) ;
}
} , Les points this à l'intérieur de tous les corps de fonction héritent de certaines méthodes de base à l'intérieur du cli.
// this.spawn
// @param - String 命令行
// @param - Args 参数
// @param - Any 默认'ingerit' ['inherit' | null ]
publishHook: {
before ( answer ) {
this . spawn ( 'gulp' , [ `--env= ${ env } ` , '--watch' ] ) ;
return Promise . resolve ( ) ;
} ,
} // this.spawnSync
// @param - String 命令行
// @param - Args 参数
// @param - Any 默认'ingerit' ['inherit' | null ]
publishHook: {
before ( answer ) {
this . spawnSync ( 'git' , [ 'add' , '.' ] ) ;
this . spawnSync ( 'git' , [ 'commit' , '-m' , `docs: 更改版本号为${ versionConf . version } ` ] ) ;
return Promise . resolve ( ) ;
} ,
} // this.log
// @param - String 文本内容
// @param - String 类型 success | error
publishHook: {
after ( answer ) {
this . log ( '成功了～' ) ;
this . log ( '成功了～' , 'error' ) ;
return Promise . resolve ( ) ;
} ,
} Voir https://github.com/SBoudrias/Inquirer.js pour plus de détails
publishHook: {
async after ( answer ) {
// 是否提交git commit
let { isCommitGitLog } = await inquirerGitCommit . call ( this ) ;
return Promise . resolve ( ) ;
}
}
function inquirerEnvAsync ( ) {
return this . inquirer . prompt ( [
{
type : 'list' ,
name : 'env' ,
message : '选择当前所使用的环境:' ,
choices : [
'online' ,
'stage' ,
] ,
}
] ) ;
}Si vous avez de bons commentaires ou suggestions, veuillez scanner le code QR ci-dessous pour communiquer ?
