代码变得更整洁的 Android 库

转自:https://mp.weixin.qq.com/s?__biz=MjM5MTM0NjQ2MQ==&mid=2650140141&idx=2&sn=78862743a5385691b946cca26f846362&chksm=beb7b79f89c03e8989f62b4fa12148ef8b8b2976e6e9a374ad56a5cc2b581cc7cf9fcae8aa30&mpshare=1&scene=1&srcid=0714F0yHeWcXzvvw07UXe7lh&pass_ticket=Ae%2BxiwckdEylxCmXTOUIDEjAuWT6Fbr8apD1GgVq6hz899BUrrcgz1i5ntWE2n2a#rd

Android开发是有趣的——这毫无疑问。然而,还是有很多平台迫使我们编写重复的样板代码。很多时候这都与需要你处理的UI组件相关。有一些确实是你需要的,当你希望你的应用程序架构能够干干净净的时候。有很多操作在后台异步执行;事实上,最后很容易成为一堆意大利面条似的代码,不可读或者就是让人感觉不正确。
今天,我们将看看6个可以帮助保持代码清晰和可读性的Android库,并且使用示例项目以方便你可以看到库的作用。
项目
我们将使用之前我们在Retrofit指南中使用过的Retrofit 2 Sample应用程序。这是一个简单的开源项目,可以在GitHub上找到。它需要一个公司名称和一个Git存储仓库,并列出所有的贡献者,贡献者显示为带有头像的一个列表。虽然它不是一个革命性的app,但是它展示了如何执行网络,使用图像,创建列表组件,以及处理用户输入。你可以随意摆弄这个功能齐全的玩具项目。
让我们将注释库应用到代码,来看看它们如何帮助维护Android app代码的整洁。

  1. Butter Knife
    每当你需要访问代码中的视图时,你需要获取该视图的对象实例。你可以通过编写rootView.findViewById()方法来实现,然后将返回的对象转换为正确的视图类型。但是,你的代码很快就会建立起来,但是尤其是在onCreate和onCreateView方法中会有恼人的类似语句。想想看;在那些onCreate方法中,你初始化一切,绑定侦听器,把整个UI绑在一起。你拥有的UI元素越多,那么单个方法就会越长。
    让我们举个简单的例子:


    Butter-Knife

    此视图将需要三个视图:两个EditTexts和一个Button,我们需要在片段中引用。一般我们会这样做:

@Overridepublic View onCreateView(LayoutInflater inflater, ViewGroup container,
                         Bundle savedInstanceState) {  // Inflate the layout for this fragment
  View rootView = inflater.inflate(R.layout.fragment_search, container, false);
  companyEditText = (EditText) rootView.findViewById(R.id.company_edittext);
  repositoryEditText = (EditText) rootView.findViewById(R.id.repository_edittext);
  searchButton = (Button) rootView.findViewById(R.id.search_button);

  searchButton.setOnClickListener(new View.OnClickListener() {    @Override
    public void onClick(View v) {
      searchContributors();
    }
  });  return rootView;
}

在代码中除了从布局中查找视图,将它们存储在活动的字段中,以及添加一个匿名内部类作为监听器来处理搜索命令之外,没有太多事情发生。通过Butter Knife,我们可以使我们的工作和编码更容易。视图对象存储在字段中,因此我们可以简单地向每个字段添加Butter Knife @BindView注解,如下所示:

@BindView(R.id.company_edittext) EditText companyEditText;
@BindView(R.id.repository_edittext) EditText repositoryEditText;
@BindView(R.id.search_button) Button searchButton;

我们还需要使onCreateView方法知道Butter Knife的存在。现在,初始化代码将只包含以下简短语句:

@Overridepublic View onCreateView(LayoutInflater inflater, ViewGroup container,
                         Bundle savedInstanceState) {  // Inflate the layout for this fragment
  View rootView = inflater.inflate(R.layout.fragment_search, container, false);
  ButterKnife.bind(this, rootView);  return rootView;
}

我们还可以进一步,跳过绑定监听器到searchButton方法,并改为注解onSearchButtonClicked方法,通过神奇地将之绑定到按钮点击的@OnClick注解:

@OnClick(R.id.search_button)
public void onSearchButtonClicked(View searchButton) {  searchContributors();
}

在官方的Butter Knife主页还有其他的例子。不妨一一查看一番!一般说来,如果你需要以编程方式访问视图元素,那么Butter Knife会让你的代码更简洁和可读。

  1. Ice Pick
    许多Android应用程序面临的一个常见问题是活动和片段生命周期的不正确处理。是啊,我们知道,它不是Android框架最优雅的部分。但是,在AndroidManifest文件中禁用横向模式,这样当用户将设备侧向移动时,应用程序不会崩溃并非是一个正确的解决方案——首先,因为显得有点傻,其次,代码不能正确处理的配置更改仍然会发生并破坏一切!因此,你必须正确处理应用程序组件的状态和生命周期。
    实现的目的是将活动中所有字段的内容存储到bundle中,然后由Android框架通过生命周期正确管理。这可能是相当无聊。
    幸运的是,Ice Pick使我们的生活变得容易多了,因为你再不必一个个添加所有的变量到bundle去保存。同样从bundle中再次读取数据,如果存在,那么会很有挑战性,但Ice Pick简化了很多很多。因此,作为示例,假设我们需要记住最后一家公司和存储库搜索的组合。
    首先,我们对要保存到bundle的字段进行注解。
@State String lastSearchCombination;

现在我们需要在onSaveInstanceState()方法中调用Ice Pick:

@Overridepublic void onSaveInstanceState(Bundle outState) {  super.onSaveInstanceState(outState);
  Icepick.saveInstanceState(this, outState);
}

也在onCreateView()方法中调用Ice Pick来恢复状态:

@Overridepublic View onCreateView(LayoutInflater inflater, ViewGroup container,
                        Bundle savedInstanceState) {  // Inflate the layout for this fragment
  View rootView = inflater.inflate(R.layout.fragment_search, container, false);
  ButterKnife.bind(this, rootView);
  Icepick.restoreInstanceState(this, savedInstanceState); 
  return rootView;
}

记住:你可以保存到bundle的内容的限制仍然存在。但是,没有必要因为为bundle键添加常量或为savedInstanceState添加空检查搞得一团乱。

  1. Dart和Henson
    与Ice Pick类似,Dart帮助我们避免为从一个活动传递到另一个活动的Intent Extras写入所有键和检查。它也适用于Fragments。这里有一个小例子,展示了我是如何使用@InjectExtra注释将搜索关键字从搜索屏幕传递到贡献者列表,实际上将执行搜索的地方。
    所以我使用@InjectExtra注解定义了两个类变量:
@InjectExtra String repositoryQuery;
@InjectExtra String companyQuery;

@InjectExtra String repositoryQuery;@InjectExtra String companyQuery;
一旦Dart.inject(this, getActivity());被调用,那么这些都将会被自动初始化。现在在Bundle中被添加到Intent的extras最终将如何。你可以手动进行,但这里使用Henson是非常有道理的。为了使它工作,我添加以下代码到我的

Intent intentContributorsFragment = 
  Henson.with(getActivity())
        .gotoContributorsFragment()
        .companyQuery(companySearchKeyword)
        .repositoryQuery(repositorySearchKeyword).build();
Intent intentContributorsActivity = 
  Henson.with(getActivity())
        .gotoContributorsActivity().build();
intentContributorsActivity.putExtras(intentContributorsFragment);
startActivity(intentContributorsActivity);

这简化了代码中Activity之间的通信,而无需每次都手动指定每个extra。

  1. Parceler
    Parceler帮助你进行对象序列化。它可以帮助你传递任何对象作为Intent extra,而不会让你面对对象序列化的烦恼。
    最好的事情是,Icepick,Henson和Dart也能很好地和Parceler一起玩。在我们的应用程序示例中,我使用@Parcel注释了我的Contributor类。这允许我使用Dart传递Contributor作为Intent Extra,使我的代码简洁和可读。

  2. Timber
    当我写代码的时候,过不了一会,我总有犯错误的倾向。通常情况下,这会导致应用程序的意外行为。我需要重现它,这样我才能解决这个问题。当你知道重现的步骤时,调试器会很方便,但是通常情况下,日志也包含了真相!
    在Android中开箱即用的Log类足够好,因为可以提供不同的日志记录级别,等等。然而,每个Log.d()语句有两个参数;首先是tag,第二是message。99%的时间里,tag将是this.class.getName(),并且一次又一次地写会很烦人。幸运的是,使用Timber库,你只要这样做:

Timber.d("Informative output that needs to be logged.");

…并且它将为你提供正确的默认tag!此外,请记住,你需要在使用之前初始化Timber。查看我已添加调用的ContributorsApplication.onCreate()代码:

Timber.plant(new Timber.DebugTree());

这就是正确初始化Timber所有需要做的事情,所有没有理由你的app不使用Timber。

  1. Dagger和Dagger2
    最后,但并非最不重要的,Dagger和Dagger2库在app中管理依赖注入的表现真令人惊叹。为你处理依赖注入是编写代码的超棒做法。你指定应用程序的组件以及它们应如何相互交互。你可以定义代码的哪些部分需要其他部件的工作,瞧,这个库将为你初始化子部件,并根据需要注入它们。你可以检查示例项目代码以查看使用示例。
    然而,Dagger和Dagger 2涉及面太广泛了,所以在这篇文章中我们就不做详细解释了。如果你想从使用Dagger开始,那么有一个很好的代码例子,coffee maker,它也得到了优秀的注释支持。

结论
有很多有趣的Android库,我在这里只列出了一些。安装起来相当容易,因为你只需要指定依赖关系就可以了。这些都是被积极维护的项目,所以它们有伟大的文档。
你要做的就是小心构建过程。当你开始结合多个库与注解处理器时,确保使用provided()或annotationprocessor(),而不是在build.gradle中将它们结合起来。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,711评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,079评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,194评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,089评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,197评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,306评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,338评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,119评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,541评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,846评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,014评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,694评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,322评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,026评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,257评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,863评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,895评论 2 351

推荐阅读更多精彩内容