Android Studio自定义模板 写页面竟然可以如此轻松

本文已授权微信公众号:鸿洋(hongyangAndroid)在微信公众号平台原创首发。

转载请标明出处:
http://blog.csdn.net/lmj623565791/article/details/51635533
本文出自:【张鸿洋的博客】

1、概述

上一篇文章,已经初步对Android Studio的模板有了初步的介绍与使用,以及一些开源模板的推荐:

本文将对如何编写Template,进行详细的介绍(以activity摸版为例)。

2、模板的文件结构

学习编写模板最好的方式呢,就是参考IDE中已经提供的最简单的模板,那么在Android Studio中最简单的activity模板就是:Empty Activity了,我们打开该模板文件,首先对文件结构有个直观的了解,如图:

可以看到每个插件对应一个文件夹,文件夹包含

  • template.xml
  • globals.xml.ftl
  • recipe.xml.ftl
  • root文件夹 存放对应源码的ftl文件,以及资源文件
  • 效果缩略图

下面我们逐一对上述每个文件的作用就行介绍。

2.1 template.xml

打开该文件,发现其主要内容如下:

<?xml version="1.0"?>
<template
    name="Empty Activity"
    minApi="7"
    minBuildApi="14"
    description="Creates a new empty activity">
    <category value="Activity" />
    <parameter
        id="activityClass"
        name="Activity Name"
        type="string"
        constraints="class|unique|nonempty"
        suggest="${layoutToActivity(layoutName)}"
        default="MainActivity"
        help="The name of the activity class to create" />

    <thumbs>
        <!-- default thumbnail is required -->
        <thumb>template_blank_activity.png</thumb>
    </thumbs>

    <globals file="globals.xml.ftl" />
    <execute file="recipe.xml.ftl" />
</template>

其中

  • <template>中的name属性,对应新建Activity时显示的名字
  • <category>对应New的类别为Activity

剩下的,对应我们AndroidStudio新建Empty Activity的界面就非常好理解了,如图:

看到这个界面,大部分属性都应该能才出来了,我们重点看parameter,界面上每一个紫色框出来的部分都对应一个parameter,部分属性介绍:

  • id :唯一标识,最终通过该属性的值,获取用户输入值(文本框内容,是否选中)
  • name:界面上的类似label的提示语
  • type : 输入值类型
  • constraints:填写值的约束
  • suggest:建议值,比如填写ActivityName的时候,会给出一个布局文件的建议值。
  • default:默认值
  • help:底部显示的提升语

这个部分对应界面还是非常好理解的,大家可以简单的修改一些字符串,或者添加一个<parameter>,重启AS,看看效果。

template.xml的最下面的部分引入了globals.xml.ftlrecipe.xml.ftl

这两个我们会详细介绍。

2.2 globals.xml.ftl

<?xml version="1.0"?>
<globals>
    <global id="hasNoActionBar" type="boolean" value="false" />
    <#include "../common/common_globals.xml.ftl" />
</globals>

通过名称可以猜到它是用于定义一些全局的变量,可以看到其内部有<global>标签,分别定义id,type,默认值。

同理,我们可以通过id的值访问到该值,例如:

${hasNoActionBar}的值为false。

2.3 recipe.xml.ftl

<recipe>

<copy from="root/res/drawable-hdpi"
            to="${escapeXmlAttribute(resOut)}/drawable-hdpi" />

<merge from="root/${resIn}/values/strings.xml.ftl"
             to="${escapeXmlAttribute(resOut)}/values/strings.xml" />

<instantiate from="root/src/app_package/SimpleActivity.java.ftl"
               to="${escapeXmlAttribute(srcOut)}/${activityClass}.java" />

<open file="${escapeXmlAttribute(srcOut)}/${activityClass}.java" />

</recipe>

为了介绍,我将该xml中比较重要的几个标签都列出来了:

  • copy :从root中copy文件到我们的目标目录,比如我们的模板Activity需要使用一些图标,那么可能就需要使用copy标签将这些图标拷贝到我们的项目对应文件夹。
  • merge : 合并的意思,比如将我们使用到的strings.xml合并到我们的项目的stirngs.xml中
  • instantiate : 和copy类似,但是可以看到上例试将ftl->java文件的,也就是说中间会通过一个步骤,将ftl中的变量都换成对应的值,那么完整的流程是ftl->freemarker process -> java
  • open:在代码生成后,打开指定的文件,比如我们新建一个Activity后,默认就会将该Activity打开。

在介绍instantiate时,涉及到了freemarker,不可避免的需要对它进行简单的介绍。

目前我们已经基本了解了一个模板其内部的文件结构了,以及每个文件大致包含的东西,我们简单做个总结:

  • template 中parameter标签,主要用于提供参数
  • global.xml.ftl 主要用于提供参数
  • recipe.xml.ftl 主要用于生成我们实际需要的代码,资源文件等;例如,利用参数+MainActivity.java.ftl -> MainActivity.java;其实就是利用参数将ftl中的变量进行替换。

那么整体的关系类似下图:

图片来源:http://www.slideshare.net/murphonic/custom-android-code-templates-15537501

3、简单的freemarker语法

上面我们已经基本了解模板生成的大致的流程以及涉及到的文件,大致了解了我们生成的源码或者xml文件,需要经过:

  • ftl->freemarker process->java/xml

这样的流程,那么我们必须对freemarker有个简单的了解。

  • 非常简单的例子

其实非常简单:

比如我们有个变量user=zhy;
有个ftl文件内容:helloL${user}
最后经过freemarker的输出结果即为 hello:zhy
  • if语法
<#if generateLayout>
    //生成layout文件
</#if>

看一眼就知道大概的意思了~有一定的编程经验,即使不知道这个叫freemarker,对于这些简单的语法还是能看懂的。

我们最后以Empty Activity模板的中的SimpleActivity为例:

root/src/app_package/SimpleActivity.java.ftl

package ${packageName};

import ${superClassFqcn};
import android.os.Bundle;

public class ${activityClass} extends ${superClass} {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
<#if generateLayout>
        setContentView(R.layout.${layoutName});
</#if>
    }
}

可以看到其内部包含很多变量,这些变量的值一般来源于用户输入和global.xml.ftl中预定义的值,经过recipe.xml.ftl中instantiate标签的处理,将变量换成实际的值,即可在我们的项目的指定位置,得到我们期望的Activity。

流程大致可用下图说明:

图片来源:http://www.slideshare.net/murphonic/custom-android-code-templates-15537501

看到这,最起码理解了,当我们选择创建不同的Activity类型,最终得到的不同的效果其中的原理原来在这。

4、具体的模板实例

了解了基本的理论之后,下面我们可以通过一个实例来将上面的知识点整合。

我们编写一个Activity模板叫做:ViewPagerWithTabActivity,用于创建一个携带TabLayout的ViewPager,效果如下:

当我们点击New->Activity->ViewPagerWithTabActivity 就可能完成上面的Activity的创建,而避免了编写布局文件,引入design库,以及一些简单的编码。

是不是感觉还是不错的,大家可以针对自己的需求,按照规范的格式随意定制模板。

建议大家copy一个现有的模板,再其基础上修改即可,比如本例是在Empty Activity基础之上修改的。

下面我们看上例的具体的实现。

4.1 template.xml的编写

通过上面的学习我们知道template.xml中可以定义我们创建面板的控件布局等,本例我们创建Activity的界面如下:

对应的template.xml如下:

<?xml version="1.0"?>
<template>

    <category value="Activity" />
    <formfactor value="Mobile" />

    <parameter id="activityClass"/>
    <parameter id="activityLayoutName"/>
    <parameter id="tabCount"/>
    <parameter id="isLauncher"/>

    <parameter id="packageName"/>
    <!-- 128x128 thumbnails relative to template.xml -->
    <thumbs>
        <!-- default thumbnail is required -->
        <thumb>template_vp_with_tab_activity.png</thumb>
    </thumbs>

    <globals file="globals.xml.ftl" />
    <execute file="recipe.xml.ftl" />

</template>

经过前面的学习应该很好理解,每个parameter对应界面上的一个控件,控件的这个id最终可以得到用户输入值,后面会用于渲染ftl文件。

4.2 用到的类

本例中最终需要生成Fragment和Activity,也就是说对应会有两个ftl文件分别用于最终生成这两个类。

  • root/src/app_package/MainActivity.java.ftl
package  ${packageName};

import android.os.Bundle;
import android.support.design.widget.TabLayout;
import android.support.v4.app.Fragment;
import android.support.v4.app.FragmentPagerAdapter;
import android.support.v4.view.ViewPager;
import android.support.v7.app.AppCompatActivity;

import ${packageName}.fragment.SimpleFragment;

public class ${activityClass} extends AppCompatActivity
{
    private TabLayout mTabLayout;
    private ViewPager mViewPager;
    private int mTabCount = ${tabCount};

    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.${activityLayoutName});

        mTabLayout = (TabLayout) findViewById(R.id.id_tablayout);
        mViewPager = (ViewPager) findViewById(R.id.id_viewpager);

        mViewPager.setAdapter(new FragmentPagerAdapter(getSupportFragmentManager())
        {
            @Override
            public Fragment getItem(int position)
            {
                return new SimpleFragment();
            }
            @Override
            public int getCount()
            {
                return mTabCount;
            }
            @Override
            public CharSequence getPageTitle(int position)
            {
                return "Tab:" + position;
            }
        });

        mTabLayout.setupWithViewPager(mViewPager);
    }
}

注意不是.java文件而是.ftl文件,可以看到上面的代码基础上和Java代码没什么区别,实际上就是Java代码,把可变的部分都换成了${变量名}的方式而已。

例如:类名是用户填写的,我们就使用${activityClass}替代,其他同理。

  • root/src/app_package/SimpleFragment.java.ftl
package ${packageName}.fragment;

import android.os.Bundle;
import android.support.annotation.Nullable;
import android.support.v4.app.Fragment;
import android.view.Gravity;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;

/**
 * Created by zhy on 16/6/6.
 */
public class SimpleFragment extends Fragment
{
    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState)
    {
        TextView tv = new TextView(getActivity());
        tv.setGravity(Gravity.CENTER);
        tv.setTextSize(40);
        tv.setText("just test");
        return tv ;
    }
}

这个类更简单,除了package是动态的,其他都写好了,主要用于作为ViewPager的Fragment Item.

4.3 用到的布局文件

  • root/res/layout/activity_main.xml.ftl
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=" ${packageName}.${activityClass}">

    <android.support.design.widget.TabLayout
        android:id="@+id/id_tablayout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
    </android.support.design.widget.TabLayout>

    <android.support.v4.view.ViewPager
        android:id="@+id/id_viewpager"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"
    />
</LinearLayout>

发现和我们真正编写的Activity并无多大区别。

看完用到的类和布局文件的ftl,大家心里应该有个底了,这模板几乎就和我们平时写的Java类一样,只是根据用户在新建Actiivty界面所输入的参数进行替换一些变量或者做一些简单的操作而已。

4.4 recipe.xml.ftl的编写

除了template.xml还有globals.xml.ftl和recipe.xml.ftl,globals.xml.ftl中基本上没有修改任何内容就不介绍了。

recipe.xml.ftl中定义的东西比较关键,例如将ftl->java,copy、合并资源文件等。

内容较长,我们拆开描述。

  • 引入依赖
<?xml version="1.0"?>
<recipe>
    <#include "../common/recipe_manifest.xml.ftl" />

    <#if !appCompat && !(hasDependency('com.android.support:support-v4'))>
            <dependency mavenUrl="com.android.support:support-v4:${buildApi}.+"/>
     </#if>

    <#if appCompat && !(hasDependency('com.android.support:appcompat-v7'))>
           <dependency mavenUrl="com.android.support:appcompat-v7:${buildApi}.+" />
    </#if>

    <#if (buildApi gte 22) && appCompat && !(hasDependency('com.android.support:design'))>
        <dependency mavenUrl="com.android.support:design:${buildApi}.+" />
    </#if>

//省略其他
</recipe>

本例依赖v4、v7、和design库,我们需要在这里定义引入;

你可能会问,这个引入的代码看起来挺复杂,你怎么知道这样写呢?

其实我也不知道怎么写,但是我可以打开IDE自带模板参考参考,copy过来就好了。

  • 剩下的内容
<?xml version="1.0"?>
<recipe>
  //省略依赖
    <instantiate from="root/src/app_package/MainActivity.java.ftl"
        to="${escapeXmlAttribute(srcOut)}/${activityClass}.java" />

    <instantiate from="root/src/app_package/SimpleFragment.java.ftl"
        to="${escapeXmlAttribute(srcOut)}/fragment/SimpleFragment.java" />   

    <instantiate from="root/res/layout/activity_main.xml.ftl"
        to="${escapeXmlAttribute(resOut)}/layout/${activityLayoutName}.xml" />

    <open file="${escapeXmlAttribute(resOut)}/layout/${activityLayoutName}.xml"/>        

    <open file="${escapeXmlAttribute(srcOut)}/${activityClass}.java" />
</recipe>

可以看到包含多个instantiate标签,该标签很明显是将我们内置的ftl转化为当前项目有中的java类。

上例,转化了

  • ${activityClass}.java
  • fragment/SimpleFragment.java"
  • /layout/${activityLayoutName}.xml

剩下是两个open标签,主要就是用于新建完成后,自动打开该文件。

本例新建完成后,Activity和其对应的布局文件都会自动打开。

恩,这里没用到merge标签,不过也很简单,假设你fragment上显示的文本,你可以定义到一个strings.xml里面,最后你需要将这个strings.xml合并到当前项目的strings.xml就可以使用merge标签(内置模板很多用了merge标签,参考下,抄一抄就搞定了)。

ok,到这,我们整个模板的编写介绍就结束了。

5、总结

本文我们首先详细介绍了一个模板文件夹下各个文件以及其内部的标签的作用,然后通过一个具体的实例,来演示如何编写一个activity模板。

如果你看的足够仔细,再花点时间动手,根据需求编写几个模板应该是不成问题的。

当然,文中一些细节并没有谈到,对于这些不要担心,你有什么需求,你就想哪个内置的模板好像有类似的需求,看它的实现,copy它的相关代码改一改就好了,没有必要去被各种文件的编写,这种东西copy修改就好了。

测试过程中,需要重启Android Studio,如果有问题,记得查看Event Log面板的信息。

此外,模板这个东西我觉得最好的集大家的力量,所以我在github建立了一个组织仓库,https://github.com/WanAndroid/AndroidStudioTemplates,如果你对模板有兴趣或者想要将自己的模板文件与他人共享,可以加入这个组织,然后分享你的代码,本文的例子也在其中。


欢迎关注我的微博:
http://weibo.com/u/3165018720


群号: 497438697 ,欢迎入群

微信公众号:hongyangAndroid
(欢迎关注,不要错过每一篇干货,支持投稿)

参考链接

  • 36
    点赞
  • 74
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 42
    评论
<h3>回答1:</h3><br/>Android Studio 是一款常用的 Android 应用开发工具,用于编 Android 应用程序。要创建自定义控件,您需要在 Android Studio 中使用 Java 或 Kotlin 编程语言编代码。 以下是创建自定义控件的基本步骤: 1. 创建一个新的 Java 或 Kotlin 类,并将其扩展为 View 类或其子类,以便您可以在其中添加自定义逻辑。 2. 在构造函数中设置自定义属性(如果有的话),以便在 XML 布局中使用它们。 3. 重 onDraw() 方法以绘制控件的外观。 4. 实现所需的触摸事件或动画,以便控件可以与用户进行交互。 5. 在布局文件中使用自定义控件。 6. 运行应用程序并测试您的自定义控件。 希望这能帮助您入门 Android Studio 中创建自定义控件的过程。 <h3>回答2:</h3><br/>Android Studio是一款用于Android开发的集成开发环境。在进行应用程序的布局时,我们可以调用系统提供的控件进行嵌入,但是有时候我们需要开发一些自己的控件,以满足特殊的需求。 自定义控件是指开发者可以通过继承系统控件或者View类,在原控件基础上进行修改或新增,以满足自己的需求,并提供相应的功能和界面。自定义控件是应用程序开发中的重要一环,可以提高程序的可读性和复用性,使UI更具有个性和美观。 自定义控件的开发需要经过几个重要的步骤。首先,我们需要根据需求选择合适的父类,一般选择继承View或其子类,以便于对控件的各个属性、方法进行定制化的修改;然后在控件的类中定义各种需要的属性,包括尺寸、颜色、字体等等;接着,我们需要处理控件的样式和外观,例如背景、边框、圆角等;最后,我们需要添加控件的功能,例如事件处理、刷新UI等等。 除了以上简单的步骤,自定义控件的开发还涉及到一些高级的技术,例如自定义属性、自定义ViewGroup、画布操作等等。自定义属性可用于方便地配置控件;自定义ViewGroup则可以将多个控件进行整体布局;画布操作则可以实现控件的高级绘制效果。 在Android Studio中,可以通过自带的工具来支持自定义控件的开发。使用该工具,可以快速轻松地创建自定义控件,而无需繁琐的手动代码编。同时,也可以通过该工具来修改已有的自定义控件,并将其添加到应用程序中。掌握Android Studio自定义控件开发,将有助于开发人员更好地完成各种Android应用程序的开发。 <h3>回答3:</h3><br/>Android Studio是一种非常流行的Java开发工具,针对在Android设备上运行的应用程序进行定制的自定义UI控件。以下是有关使用Android Studio创建自定义控件的详细解释。 首先,开发人员需要了解Android操作系统的基本视图层次结构。在Android应用程序中,屏幕上的一切都被认为是视图,这些视图可以是简单的单个元素,也可以是更复杂的嵌套组合。每个视图都有一个类,用于定义其外观和行为。 为了创建自定义控件,我们需要创建一个新的视图类,该类将扩展现有的视图类。这可以通过继承现有的Android SDK视图类来实现,比如TextView或Button。 如果需要定制视图的外观,可以在新类中重父类的某些方法。例如,可以重onDraw()方法来绘制自定义形状或颜色。 要添加自定义行为,可以通过在类中添加新方法来实现。例如,如果要创建一个绘制流程图的视图,可以创建一个绘制线条和节点的方法。 在创建与视图关联的XML布局文件时,必须手动定义新视图类的属性。可以使用自定义属性声明XML命名空间,并将属性添加到视图类中。这些属性可以在代码中编程访问,并允许开发人员在XML和Java代码中控制视图。 一旦创建了自定义控件类,就可以像使用任何其他视图类一样添加它们到XML布局文件中。 总而言之,在Android Studio中开发自定义控件是一项具有挑战性但有益的任务。理解应用程序的视图层次结构和重现有控件类的方法可能需要一些时间和实践,但最终的结果是定制外观和行为的完全可控控件。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 42
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

鸿洋_

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值