189 8069 5689

AndroidStudio模板中怎么使用文件组

Android Studio模板中怎么使用文件组,针对这个问题,这篇文章详细介绍了相对应的分析和解答,希望可以帮助更多想解决这个问题的小伙伴找到更简单易行的方法。

成都网站建设哪家好,找创新互联!专注于网页设计、成都网站建设公司、微信开发、小程序设计、集团成都定制网页设计等服务项目。核心团队均拥有互联网行业多年经验,服务众多知名企业客户;涵盖的客户类型包括:成都玻璃钢坐凳等众多领域,积累了大量丰富的经验,同时也获得了客户的一致夸奖!

已有工程中使用模板效果图 

Android Studio模板中怎么使用文件组

创建工程时使用模板

Android Studio模板中怎么使用文件组

示例场景

在进行Android开发时,我们经常会创建一个Demo工程,目的可能有很多种,可能是为了验证一个问题,可能是为了学习一个框架的使用,可能为了测试自己写的一个lib库等等。这个时候我们可能会创建一个Activity,然后再在xml写一些按钮,再在Activity里写该按钮的事件监听逻辑,也就是说为了执行一段代码我们要做这么多操作。为了简化这段重复操作,我这边写了一个DebugActivity类,然后支持我们只需要写个子类来继承它,然后像下面这样写几个方法即可,运行的时候会根据方法动态创建按钮,并在点击按钮时执行该方法的代码逻辑。

public void _test() {  T("弹出Toast");  }

由于本文主要介绍模板相关的,所以该场景相关的具体代码技术细节就不多说了,有兴趣的可以看下,DebugActivity的代码,这里提出来只是为模板开发简单的做个铺垫。

模板位置

Android Studio Template中有系统预设的一些模板,我们可以直接修改,也可以另行添加新的模板。打开Android  Studio安装目录/Contents/plugins/android/lib/templates这个文件夹我们能看到下面的目录结构,这里便是AS中模板存放的位置。

Android Studio模板中怎么使用文件组

我们接下来的工作也就在这里,保险起见我们在这里新建一个目录,我们自己写的模板都放在自己新建的目录里,例如我这里就创建了一个叫pk的目录。

模板规范

在上面的基础上,我们可以直接打开/activies/EmptyActivity目录,如下图

Android Studio模板中怎么使用文件组

我们可以看到上面红色区域便是Template的文件结构,大致说下各个文件(夹)的含义

  • globals.xml.ftl 模板中参数配置的地方(可选)

  • recipe.xml.ftl  模板行为执行处,引入这个模板之后,接下来要做什么事情,就是它说的算(可选,但是不选就没有意义了,因为模板引入是要要行为驱动的)

  • root  存放模板文件及引入资源的目录,模板文件可以是.xml、.java、.gradle等任何一个文本格式的文件,资源一般是我们引入的.png资源文件(可选,不选同上)

  • template_blank_activity.png 引入模板时的引导图(可选)

  • template.xml 面向模板引擎的配置文件(必选)

我们可以看到,真正核心的部分就是root、recipe.xml.ftl和template.xml,接下来这重点说明这三部分。

我们可以打开root目录,能够看到里面的文件除了图片资源文件都是以.ftl结尾的,而.ftl是标准的FreeMarker的文件。FreeMarker是类似于Velocity的一种模板框架,据说对于多文件处理时它具有更好的性能,大概也是Android  Studio选择Velocity作为单文件模板,选择FreeMarker作为文件组模板的原因吧。有兴趣的可以去FreeMarker官网学习一下,它的自定义标签功能还是很强大的,个人感觉比Velocity的更加接地气。

接下来我们看一下recipe.xml.ftl 的内容,打开如下

Android Studio模板中怎么使用文件组

这里以<#开头的都是FreeMarker的语法,基本上比葫芦画瓢就能看明白,就不多说了。其实对于这个文件最重要的部分是下面四个标签:

  • copy 就是简单的copy,把模板root目录下的某个文件copy到目标工程的某个目录下

  • instantiate  跟copy很类似,***多的一点功能就是并不只简单的走IO流进行copy,而是通过FreeMarker框架按照模板中的FreeMarker能识别的逻辑判断和数据引入来生成最终的目标文件

  • merge  目标项目中有了某文件,而我们还要想该文件合并一些我们的模板的部分时,就选用merge,例如我们添加一个Activity时需要mergeAndroidManifest.xml的配置。目前支持的merge格式有.xml和.gradle,但是对.gradle支持的不怎么好,不过不影响该模板的开发,对于这套模板引擎的开发者来说,这可能是最麻烦的部分了,但是对于我们使用者就不用考那么多了,直接使用吧

  • open 这个很简单,就是指定模板引入之后要IDE打开的文件

然后看下template.xml内容

                                                                                  template_blank_activity.png                    

当我们进行模板引入时,AS会弹出一个如下图的UI界面,要我们来填入或选择一些数据,例如输入Activity的的名称,选择SDK的版本之类的。而这个界面就是根据由该文件而来的。

Android Studio模板中怎么使用文件组

内容比较多,为减少篇幅我挑些重要的说

  • template标签

    • name 引入模板时的模板名称,就死根据他选择哪个模板的

    • description 弹出Dialog的标题,对应上去的区域1

  • category 表示该模板属于哪种分类,在引入的时候会有个分类的选择

  • parameter 每个该标签就对应Dialog界面的一个输入项

    • id 该参数的***标识符,也是我们在.ftl中引入的值,例如定义的id为username,引用时就是$username

    • name 对应Dialog上面该输入项的名称

    • type 对应该参数的类型,Dialog就是根据这个来决定对应输入是选择框、输入框还是下拉框等等

    • constraints 对应该参数的约束,如果有多个要用|分割开

    • suggest 建议值,这个输入部分是由级联效应的,可能你改了A参数,B参数也会跟着改变,就是根据这个参数决定的

    • default 参数的默认值

    • visibility 可见性,要配置一个boolean类型的参数,一般指向另一个输入源

    • help 当焦点在某个输入源上面时,上图的区域3的就限制这儿的内容

操刀实战

了解了模板规范之后,我们编写模板时就不会那么被动了,下面我们来自己动手编写文章开始部分展示的模板。

首先在刚才提到的自定义的模板下创建如下图所示的目录结构

Android Studio模板中怎么使用文件组

然后将下面的代码对应贴进去(图片部分随便找一张代替好了…)

globals.xml.ftl

Android Studio模板中怎么使用文件组

recipe.xml.ftl

Android Studio模板中怎么使用文件组

template.xml

                                                                                        template_debug_activity.png                    

AndroidManifest.xml.ftl

Android Studio模板中怎么使用文件组

DebugActivity.java.ftl

package ${packageName};  import android.app.Activity;  import android.content.Context;  import android.content.Intent;  import android.os.Bundle;  import android.util.Log;  import android.view.View;  import android.widget.Button;  import android.widget.LinearLayout;  import android.widget.ScrollView;  import android.widget.Toast;  import java.lang.annotation.ElementType;  import java.lang.annotation.Retention;  import java.lang.annotation.RetentionPolicy;  import java.lang.annotation.Target;  import java.lang.reflect.Method;  import java.util.ArrayList;  import java.util.List;  /**   * Debug测试类,快速调试Demo工程   * 使用姿势:   * 1. 新建一个子类继承该类   * 2. 跳转Activity: 在子类配置{@link Jump}注解, 然后在注解中配置跳转Activity的类型   * 3. 点击按钮触发方法: 在子类声明一个名称以"_"开头的方法(支持任意修饰符),最终生成按钮的文字便是改方法截去"_"   * 4. 方法参数支持缺省参数和单个参数   * 5. 如果是单个参数,参数类型必须是Button或Button的父类类型,当方法执行时,该参数会被赋值为该Buttom对象   * https://github.com/puke3615/DebugActivity   * 

   *   * @author zijiao   * @version 16/10/16   */  public abstract class DebugActivity extends Activity {      protected static final String FIXED_PREFIX = "_";      private final String TAG = getClass().getName();      private final List buttonItems = new ArrayList<>();      protected LinearLayout linearLayout;      protected Context context;      @Target(ElementType.TYPE)      @Retention(RetentionPolicy.RUNTIME)      public @interface Jump {          Class[] value() default {};      }      @Override      protected void onCreate(Bundle savedInstanceState) {          super.onCreate(savedInstanceState);          this.context = this;          ScrollView scrollView = new ScrollView(this);          setContentView(scrollView);          this.linearLayout = new LinearLayout(this);          this.linearLayout.setOrientation(LinearLayout.VERTICAL);          scrollView.addView(linearLayout);          try {              resolveConfig();              createButton();          } catch (Throwable e) {              error(e.getMessage());          }      }      private void createButton() {          for (ButtonItem buttonItem : buttonItems) {              linearLayout.addView(buildButton(buttonItem));          }      }      protected View buildButton(final ButtonItem buttonItem) {          final Button button = new Button(this);          button.setText(buttonItem.name);          button.setOnClickListener(new View.OnClickListener() {              @Override              public void onClick(View v) {                  if (buttonItem.target != null) {                      to(buttonItem.target);                  } else {                      Method method = buttonItem.method;                      method.setAccessible(true);                      Class[] parameterTypes = method.getParameterTypes();                      int paramSize = parameterTypes.length;                      switch (paramSize) {                          case 0:                              try {                                  method.invoke(DebugActivity.this);                              } catch (Throwable e) {                                  e.printStackTrace();                                  error(e.getMessage());                              }                              break;                          case 1:                              if (parameterTypes[0].isAssignableFrom(Button.class)) {                                  try {                                      method.invoke(DebugActivity.this, button);                                  } catch (Throwable e) {                                      e.printStackTrace();                                      error(e.getMessage());                                  }                                  break;                              }                          default:                              error(method.getName() + "方法参数配置错误.");                              break;                      }                  }              }          });          return button;      }      private void resolveConfig() {          Class cls = getClass();          //读取跳转配置          if (cls.isAnnotationPresent(Jump.class)) {              Jump annotation = cls.getAnnotation(Jump.class);              for (Class activityClass : annotation.value()) {                  buttonItems.add(buildJumpActivityItem(activityClass));              }          }          //读取方法          for (Method method : cls.getDeclaredMethods()) {              handleMethod(method);          }      }      protected void handleMethod(Method method) {          String methodName = method.getName();          if (methodName.startsWith(FIXED_PREFIX)) {              methodName = methodName.replaceFirst(FIXED_PREFIX, "");              ButtonItem buttonItem = new ButtonItem();              buttonItem.method = method;              buttonItem.name = methodName;              buttonItems.add(buttonItem);          }      }      protected ButtonItem buildJumpActivityItem(Class activityClass) {          ButtonItem buttonItem = new ButtonItem();          buttonItem.name = "跳转到" + activityClass.getSimpleName();          buttonItem.target = activityClass;          return buttonItem;      }      public void L(Object s) {          Log.i(TAG, s + "");      }      public void error(String errorMessage) {          T("[错误信息]\n" + errorMessage);      }      public void T(Object message) {          Toast.makeText(context, String.valueOf(message), Toast.LENGTH_SHORT).show();      }      public void to(Class target) {          try {              startActivity(new Intent(this, target));          } catch (Exception e) {              e.printStackTrace();              error(e.getMessage());          }      }      public void T(String format, Object... values) {          T(String.format(format, values));      }      protected static class ButtonItem {          public String name;          public Method method;          public Class target;      }  }

JumpActivity.java.ftl

Android Studio模板中怎么使用文件组

SimpleActivity.java.ftl

package ${packageName};  @DebugActivity.Jump({  <#if addJumpActivity>      JumpActivity.class,  <#else>    })  public class ${activityClass} extends DebugActivity {  <#if addExample>      private int number = 0;      public void _无参方法调用() {      T("无参方法调用");      }      public void _有参方法调用(Button button) {          button.setText("number is " + number++);      }      //代码执行不到,直接弹出toast提示报错      public void _错误参数调用(String msg) {          T("test");      }      //方法名没有以"_"开头,按钮无法创建成功      public void 无效调用() {          T("test");      }      //crash会被会被catch住,以toast方式弹出      public void _Crash测试() {          int a = 1 / 0;      }    }

ok,到此对于该模板的编写过程就结束了,接下来重启下Android Studio,然后New  Project一路next下去,直到这个界面,这里就是我们自定义的DebugActivity模板了

Android Studio模板中怎么使用文件组

关于Android Studio模板中怎么使用文件组问题的解答就分享到这里了,希望以上内容可以对大家有一定的帮助,如果你还有很多疑惑没有解开,可以关注创新互联行业资讯频道了解更多相关知识。


当前标题:AndroidStudio模板中怎么使用文件组
标题URL:http://cdxtjz.cn/article/ihipih.html

其他资讯