(快速参考)

应用资料

4.0.2

应用资料

使用以下命令创建365bet地区应用程序时创建应用默认情况下,使用Web配置文件的命令

grails创建应用程序myapp

您可以使用profile参数指定其他配置文件

grails创建应用程序myapp个人资料其余api

概要文件封装了旨在用于给定概要文件的项目命令模板和插件。可以找到概要文件的源在Github上而配置文件本身作为JAR文件发布到365bet地区中央存储库

要找出可用的配置文件,请使用列出个人资料命令

grails列表配置文件

有关特定配置文件的更多信息,请使用个人资料信息命令

grails的个人资料信息REST API
诸如以下命令个人资料信息要么列出个人资料在grails项目中调用365bet地区 CLI时不可用

配置文件存储库

默认情况下,365bet地区将从365bet地区中央存储库但是,您可以通过在列表中指定存储库来覆盖要搜索的存储库USER HOME grails设置groovy文件

如果除了365bet地区中央存储库之外,还希望使用自定义存储库解析配置文件,则还必须在文件中指定365bet地区中央存储库

grails配置文件存储库myRepo url"http foo com回购"snapshotsEnabledgrails中央网址"https repo grails org grails核心"snapshotsEnabled
      }
    }
  }
}
当Gradle实例尚不可用时,365bet地区使用Aether来解析配置文件。创建应用命令执行这意味着您还可以在您的系统中定义存储库和更高级的配置代理身份验证等USER HOME m设置xml如果你愿意的话

也可以将简档存储库的简单凭证直接存储在USER HOME grails设置groovy文件

grails配置文件存储库myRepo url"http foo com回购"snapshotsEnabled用户名""密码"通过"
      }
      ...
    }
  }
}

配置文件默认值

要创建使用定制概要文件的应用程序,必须指定完整的工件

grails创建应用程序myapp个人资料com mycompany grails个人资料myprofile

为了简化此过程,您可以在USER HOME grails设置groovy文件

grails个人资料myprofile groupId"com mycompany grails档案""1.0.0"仓库

使用指定的默认值,使用该概要文件创建应用程序的命令将变为

grails创建应用程序myapp个人资料myprofile

创建配置文件

创建新配置文件的想法是,您可以设置针对特定技术或组织的默认命令和插件集

要创建新的配置文件,您可以使用创建个人资料该命令将创建一个新的空配置文件,以扩展基本配置文件

grails创建个人资料mycompany

上面的命令将在执行命令的mycompany目录中创建一个新的配置文件。如果在目录中启动交互模式,将获得一组用于创建配置文件的命令

cd mycompany grails输入要运行的命令名称使用TAB进行完成grails create命令create creator命令创建功能create generator命令create gradle命令创建模板

命令如下

  • 创建命令创建一个新命令,当使用配置文件时,该命令将从365bet地区 CLI中可用

  • 创建创建者命令创建可用于CLI的命令,以渲染模板示例create controller

  • 创建生成器命令创建一个可用于CLI的命令,该命令基于域类渲染模板

  • 创建功能创建可与此配置文件一起使用的功能

  • 创建gradle命令创建一个可以调用gradle的CLI命令

  • 创建模板创建可以由命令呈现的模板

要为您的配置文件自定义依赖性,您可以在中指定其他依赖性yml个人资料.

下面是一个例子yml个人资料文件

特征:
    默认值:
        - 
        - 资产管道
建立:
    外挂程式:
        - 组织grails grails网站
    排除:
        - 组织grails grails核心
依存关系:
    编译:
        - "org mycompany myplugin"

完成上述配置后,您可以使用以下方式将配置文件发布到本地存储库gradle安装:

gradle安装

您的个人资料现在可用于创建应用命令

grails创建应用程序myapp个人资料mycompany

使用上面的命令,将使用mycompany配置文件创建应用程序,该配置文件包括对myplugin插件的附加依赖关系,还包括休眠和资产管道功能,稍后将详细介绍功能

请注意,如果您自定义配置文件组版本等的依赖项坐标,则可能需要使用完全限定的坐标来创建应用程序

grails创建应用程序myapp个人资料com mycompany mycompany

配置文件继承

一个配置文件可以扩展一个或多个不同的父配置文件。要定义配置文件继承,您可以修改建立gradle概要文件并定义概要文件相关性例如,通常您想扩展基础轮廓

依赖项运行时项目'基础')
}

通过从父级配置文件继承,您可以获得以下好处

  • 当。。。的时候创建应用执行命令,首先复制父配置文件的骨架

  • 依赖关系和建立gradle从父s合并

  • 文件是从父s合并的

  • 父配置文件的CLI命令被继承

  • 父配置文件中的特征被继承

要定义继承的顺序,请确保以正确的顺序声明依赖项。例如

依赖项运行时项目'插入'运行时项目'网络')
}

在以上代码段中,首先复制了插件配置文件的框架,然后复制了Web配置文件。此外,Web配置文件覆盖了插件配置文件中的命令,而如果颠倒了依存顺序,则插件配置文件将覆盖Web配置文件

发布资料

将配置文件发布到365bet地区中央存储库

使用创建的任何配置文件创建个人资料命令已经配置了一个grails个人资料发布在中定义的插件建立gradle:

应用插入: "org grails grails资料发布"

要将使用此插件的配置文件发布到365bet地区中央存储库,请先将源文件上传到Github不接受封闭源配置文件,然后在上注册帐户宾特雷并按照配置文件中的以下步骤配置密钥建立gradle文件

grails发布用户'您的用户名''您的钥匙'githubSlug'您的回购您的个人资料'执照'阿帕奇'
}
githubSlug参数应指向您的Github存储库的路径,例如,如果您的存储库位于https github com foo栏然后你的githubSlug富吧

有了这个就可以运行gradle publish个人资料发布您的个人资料

gradle publish个人资料

个人资料将上传到Bintray,然后您可以365bet地区个人资料存储库并要求通过单击Bintray界面上的“包括我的包裹”按钮来包含您的个人资料,您必须先登录才能看到此信息

将配置文件发布到内部存储库

之前所提grails个人资料发布插件配置Gradle的Maven Publish插件为了发布到内部存储库,您需要做的就是在建立gradle例如

发布存储库Maven凭证用户名""密码"酒吧"网址"http foo com回购"
        }
    }
}

配置完成后,您可以通过以下方式发布插件gradle发布:

gradle发布

了解配置文件

配置文件是一个简单的目录,其中包含一个yml个人资料包含配置文件定义的命令框架和模板的文件和目录

Web命令创建控制器yml运行应用程序groovy功能资产管道骨架功能yml骨架grails应用程序控制器构建gradle模板工件控制器groovy配置文件yml

上面的示例是网络配置文件结构的摘要yml个人资料该文件用于描述配置文件并控制如何配置内部版本

了解配置文件yml描述符

yml个人资料可以包含以下子元素

仓库

包含在生成的构建示例中的Maven存储库列表

仓库:
    - "https repo grails org grails核心"

建立储存库

包含在生成的构建示例的buildscript部分中的Maven存储库列表

建立:
    仓库:
        - "https repo grails org grails核心"

构建插件

在生成的示例中配置的Gradle插件列表

建立:
    外挂程式:
        - 日食
        - 理念
        - 组织grails grails核心

建立排除

从父配置文件中继承的Gradle插件列表

建立:
    排除:
        - 组织grails grails核心

依存关系

范围和依赖关系图,用于配置排除范围可用于从父配置文件中排除

依存关系:
    排除:
        - "组织grails休眠"
    建立:
        - "org grails grails gradle gradle插件grailsVersion"
    编译:
        - "org springframework boot spring boot starter logging"
        - "org springframework boot spring boot autoconfigure"

功能默认

如果未指定显式功能,则使用的默认功能列表

特征:
    默认值:
        - 
        - 资产管道

骨架排除

从父配置文件的骨架中排除的文件列表支持通配符

骨架:
    排除gradlew gradlew蝙蝠gradle

骨架父目标

父配置文件的骨架应复制到的目标文件夹。该文件夹可用于创建多项目构建

骨架:
    父母:
        目标应用程式

骨架二进制扩展

哪些文件扩展名应作为二进制文件从配置文件复制继承并从父配置文件合并

骨架:
    binaryExtensionsexe压缩

骨架可执行文件

在结果应用程序中应标记为可执行的文件模式从父概要文件继承并组合蚂蚁.

骨架:
    可执行文件:
      - "Gradlew"
      - "365bet地区w"

指示

创建应用程序后要向用户显示的文本

指示这是一些说明

使用配置文件时会发生什么

当。。。的时候创建应用该命令运行时将获取父概要文件的框架并将框架复制到新的项目结构中

建立gradle生成文件是获得以下文件中定义的所有依赖项信息的结果yml个人资料文件并产生所需的依赖关系

该命令还将合并任何建立gradle配置文件及其父配置文件中定义的文件

grails应用配置会议应用yml文件还考虑到配置文件和所有父配置文件合并到一个YAML文件中

创建配置文件命令

配置文件可以使用YAML或Groovy脚本定义仅适用于该配置文件的新命令,以下是一个示例。YAML中定义的命令

描述:
    - 创建一个控制器
    - 用法创建控制器>'
    - 完成者组织grails CLI交互式完成者DomainClassCompleter
    - 参数控制器名称
      描述: "控制器名称"
脚步:
 - 命令渲染
   模板: 模板工件控制器常规
   目的地: grails应用程序控制器构件工件包路径构件名称控制器groovy
 - 命令渲染
   模板: 模板测试Controller groovy
   目的地: src测试groovy神器包路径神器名称ControllerSpec groovy
 - 命令mkdir
   位置: grails应用程序视图工件artifactName

YAML中定义的命令必须定义一个或多个步骤。每个步骤本身就是一个命令。可用的步骤类型为

  • 渲染如上例所示,将模板渲染到给定的目标

  • 麦克迪尔制作目录指定的位置参数

  • 执行执行由参数必须是实现命令接口

  • 摇动执行一个或多个Gradle指定的任务任务参数

例如,要调用Gradle任务,您可以定义以下YAML

描述: 创建一个WAR文件以部署到像Tomcat这样的容器
minAguments: 0
用法: |战争
脚步:
 - 命令gradle
   任务:
     - 战争

如果您需要比声明性YAML方法提供的灵活性更大的灵活性,则可以创建Groovy脚本命令。每个Command脚本都从GroovyScriptCommand类,因此可以使用该类的所有方法

以下是一个示例用Groovy编写的命令

描述"创建一个365bet地区脚本"用法"grails创建脚本