Merge pull request #1 from bboyfeiyu/master

update
hehonghui · Dec 15, 2015 · 1f85365 · 1f85365
2 parents 4c94fc0 + 75657d6
commit 1f85365
Show file tree

Hide file tree

Showing 10 changed files with 1,065 additions and 13 deletions.
diff --git a/androidweekly/剪刀手—Android平台上的图片裁剪库.md b/androidweekly/剪刀手—Android平台上的图片裁剪库.md
@@ -0,0 +1,68 @@
+剪刀手:Android平台上的图片裁剪库
+---
+
+> * 原文链接 : [Scissors: an image cropping library for Android](https://eng.lyft.com/scissors-an-image-cropping-library-for-android-a56369154a19#.ebe64l3dy)
+* 原文作者 : [Evelio Tarazona](https://medium.com/@eveliotc)
+* 译文出自 : [开发技术前线 www.devtf.cn。本译文已授权开发者头条（链接：http://toutiao.io/download）享有独家转载权，未经允许，不得转载!](http://www.devtf.cn)
+* 译者 : [Damonzh](https://github.com/Damonzh) 
+* 校对者: [这里校对者的github用户名](github链接)  
+* 状态 :  未完成 / 校对中 / 完成 
+
+
+几个月前我们往我们的App中[引入个人简介功能](http://blog.lyft.com/posts/profiles)后，Helen——我们其中一个特性团队的工程师——接到了对个人简介进行第二次迭代的任务。这次版本迭代包括了众多的改进，其中包括支持自定义个人头像功能，头像可以用相机直接拍摄，也可以从Gallery或者Photos这类相册App中选择。
+
+![Lyft的Android版本自定义图像的早期设计](https://cdn-images-1.medium.com/max/1600/1*An_iDXn6RtufzwUIdSUc-w.png)
+Lyft的Android版本自定义头像的早期设计
+
+在图片被上传到服务器之前，图片必须被裁剪以符合一定的要求，这其中包括:
+
+* 放大到原尺寸的200%
+* 移动和截图
+* 不管在什么样的屏幕密度上都保持固定的比例
+* 基于当前屏幕尺寸进行裁剪
+
+因为在Lyft我们都喜欢开源，所以自然而然的想到了搜索现成的解决方案。但是没有一个能满足我们的需求，所以我们决定自己动手实现这个需求。一晃几个月过去了，我们现在打算将这个库([Scissors](https://github.com/lyft/scissors))的核心代码开源。
+
+## Scissors
+![](https://cdn-images-1.medium.com/max/1600/1*o9wj6y7Xt5zn6nHI4p5t7Q.png)
+
+### 这个库能做什么？
+[Scissors](https://github.com/lyft/scissors)提供了一个叫做**CropView**的控件，它继承于[ImageView](https://developer.android.com/reference/android/widget/ImageView.html)并且提供了熟悉的方式来提供用于裁剪的图像，比如使用[setImageBitmap](https://developer.android.com/reference/android/widget/ImageView.html#setImageBitmap%28android.graphics.Bitmap%29)来设置要裁剪的图像。一旦用户设置好了要裁剪的位置和缩放比例(这受限于cropviewMaxScale和cropviewMinScale)只需调用
+
+~~~java
+Bitmap croppedBitmap = cropView.crop();
+~~~
+该方法返回的Bitmap符合视图的尺寸，这个尺寸可以通过cropviewViewportHeightRatio来进行控制。  
+
+![](https://cdn-images-1.medium.com/max/1600/1*SbhkZppPqhMwj4CdcrFS_w.gif)  
+
+### 扩展
+我们也提供了一些实用的扩展来进行一些常见的任务，比如:  
+
+* 使用[Picasso](https://github.com/square/picasso)或者[Glide](https://github.com/bumptech/glide)往CropView里加载Bitmap并且让图片适应视图的尺寸
+
+ ~~~java
+cropView.extensions()
+ .load(galleryUri);
+ ~~~ 
+
+ 你也可以用你喜欢的方式创建自定义的BitmapLoader来提供Bitmap
+
+ *在不阻塞主线程的前提下保存裁剪好的Bitmap到文件或者流中
+
+ ~~~java
+ cropView.extensions()
+ .crop()
+ .quality(87)
+ .format(PNG)
+ .into(croppedFile);
+ ~~~
+
+ 你也可以指定裁剪后输出到文件或者流中的图片格式和质量
+
+### 未来的计划
+我们想让Scissors越来越好用，所以以后Scissors将会支持[双击拖动与缩放](https://github.com/lyft/scissors/issues/1)，同时也会[修复一些bug和进行一些优化](https://github.com/lyft/scissors/issues/)。我们希望Scissors对你来说是有用的并且能够满足你所有关于图片裁剪的需求。
+
+[开始使用Scissors吧](https://github.com/lyft/scissors)
+
+
diff --git a/androidweekly/重构Plaid-响应式的MVP模式-一/readme.md b/androidweekly/重构Plaid-响应式的MVP模式-一/readme.md
diff --git a/androidweekly/高性能ListViews/高性能ListViews.md b/androidweekly/高性能ListViews/高性能ListViews.md
@@ -2,11 +2,11 @@
 ---
 
 > * 原文链接 : [Performance ListViews](http://willowtreeapps.com/blog/performance-listviews/?utm_source=Android+Weekly&utm_campaign=038d344835-Android_Weekly_178&utm_medium=email&utm_term=0_4eb677ad19-038d344835-337955857)
-* 原文作者 : [Brandon](ttp://willowtreeapps.com/blog/)
+* 原文作者 : [Brandon](http://willowtreeapps.com/blog/)
 * 译文出自 : [开发技术前线 www.devtf.cn。未经允许，不得转载!](http://www.devtf.cn)
 * 译者 : [liuling07](https://github.com/liuling07) 
-* 校对者: [这里校对者的github用户名](github链接)  
-* 状态 :  未完成 / 校对中 / 完成 
+* 校对者: [desmond1121](https://github.com/desmond1121)  
+* 状态 :  完成 
 
 列表展示功能几乎在所有app中都会被用到，使用列表可以很方便的展示一些列表项，比如菜谱、联系人，或者任意类型的类别。所以Android有一个内置的方式来展示此类型的数据，也是在情理之中的。RecyclerView是一种最新的展示列表数据的方式，它非常高效，因为它重用视图而不是每一行出现在屏幕上都重新创建。在RecyclerView出现之前，我们可以使用ListView，即使到了现在，ListView也是广泛的被开发者所使用。虽然ListView也是可以回收视图的，但它也一直都是Android中最容易被错误使用的一个控件。我们知道在此之前这个话题已经被写过无数遍了，但是今天我还是要在博客中提出来，因为我们仍然发现很多app在错误的使用它们。
 

diff --git a/androidweekly/高效地配置okhttp.md b/androidweekly/高效地配置okhttp.md
@@ -0,0 +1,166 @@
+高效地配置OkHttp
+---
+
+> * 原文链接 : [Effective OkHttp](http://omgitsmgp.com/2015/12/02/effective-okhttp/)
+* 原文作者 : [Michael Parker](http://omgitsmgp.com/)
+* 译文出自 : [开发技术前线 www.devtf.cn。本译文已授权开发者头条（链接：http://toutiao.io/download）享有独家转载权，未经允许，不得转载!](http://www.devtf.cn)
+* 译者 : [Damonzh](https://github.com/Damonzh) 
+* 校对者: [desmond1121](https://github.com/desmond1121)  
+* 状态 :  完成 
+
+当我为[可汗学院](https://www.khanacademy.org/)开发[Android app](https://play.google.com/store/apps/details?id=org.khanacademy.android)的时候，[OkHttp](http://square.github.io/okhttp/)是一个十分有用的第三方库。虽然它的默认设置已经提供了很大的便利，但我们还是采取了以下的步骤使OkHttp更加高效与智能:  
+
+### 1. 开启响应数据缓存到文件系统功能  
+允许缓存响应数据时需要往请求头里加入`Cache-Control`，默认情况下OkHttp不会缓存响应数据。所以，客户端就会浪费时间和流量去多次请求同样的数据。相反的，如果缓存了响应数据，只需要在第一次请求的时候从网络获取，以后就可以直接从缓存文件中获取数据。 
+
+
+为了开启缓存响应数据功能，你需要创建一个`com.squareup.okhttp.Cache`对象并将其作为参数传给`OkHttpClient`的`setCache`方法。在创建`Cache`对象的时候，你必须为其指定一个`File`参数和以byte为单位的最大容量参数，这个File代表了缓存的路径。缓存的数据会被存储在这个路径中。当缓存的大小超过指定的最大容量时，OkHttp会根据[LRU算法](https://en.wikipedia.org/wiki/Cache_algorithms#LRU)对缓存数据进行清理操作。  
+
+根据[Jesse Wilson](http://stackoverflow.com/a/32752861/400717)的推荐，我们把缓存的数据存放在`context.getCacheDir()`的子目录中:
+
+~~~java
+// Base directory recommended by http://stackoverflow.com/a/32752861/400717.
+// Guard against null, which is possible according to
+// https://groups.google.com/d/msg/android-developers/-694j87eXVU/YYs4b6kextwJ and
+// http://stackoverflow.com/q/4441849/400717.
+final @Nullable File baseDir = context.getCacheDir();
+if (baseDir != null) {
+  final File cacheDir = new File(baseDir, "HttpResponseCache");
+  okHttpClient.setCache(new Cache(cacheDir, HTTP_RESPONSE_DISK_CACHE_MAX_SIZE));
+}
+~~~
+
+在可汗学院App中，我们指定`HTTP_RESPONSE_DISK_CACHE_MAX_SIZE`的值为`10 * 1024 * 1024`，即10MB。  
+
+### 2. 集成Stetho
+[Stetho](http://facebook.github.io/stetho/)是由Facebook开发的一个实用的库，它可以让你使用Chrome提供的[Chrome Developer Tools](https://developers.google.com/web/tools/setup/workspace/setup-devtools)来审查你的Android应用的代码。  
+
+除了可以让你审查应用中的SQLite数据库和View的继承层次外，Stetho也可以审查OkHttp发起的每一个请求和收到的每一个响应:  
+
+![](http://omgitsmgp.com/assets/images/posts/stetho-inspector-network.png)  
+
+这个拦截器可以确保服务端返回的HTTP头允许缓存相关数据，而且也可以保证如果有缓存数据的话不会进行网络请求。  
+
+使用Stetho也很简单，往网络拦截器列表中添加一个`StethoInterceptor`对象就可以了:  
+
+~~~java
+okHttpClient.networkInterceptors().add(new StethoInterceptor());
+~~~  
+
+然后运行你的应用并且打开Chrome，导航到`chrome://inspect`。
+这时应该就会有一个设备和应用id的列表。点击'inspect'链接来打开Developer Tools，然后打开NetWork标签就可以观察OkHttp的请求了。   
+
+### 3. 在你的应用中使用Picasso and Retrofit
+如果你也像我们一样使用[Picasso](http://square.github.io/picasso/)加载网络图片，或者使用[Retrofit](http://square.github.io/retrofit/)简化网络请求和数据解析。在你没有明确指定一个`OkHttpClient`的情况下，这些库会自己创建一个默认的供内部使用。比如2.5.2的Picasso中`OkHttpDownloader`类是如下这样:  
+
+~~~java
+private static OkHttpClient defaultOkHttpClient() {
+  OkHttpClient client = new OkHttpClient();
+  client.setConnectTimeout(Utils.DEFAULT_CONNECT_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);
+  client.setReadTimeout(Utils.DEFAULT_READ_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);
+  client.setWriteTimeout(Utils.DEFAULT_WRITE_TIMEOUT_MILLIS, TimeUnit.MILLISECONDS);
+  return client;
+}
+~~~
+Retrofit有一个类似的工厂方法来创建自己的`OkHttpClient`。   
+
+图片是一个应用中比较大的资源。Picasso使用LRU算法对图片进行了缓存，严格来说是内存缓存。如果客户端试图使用Picasso加载一张图片，但是Picasso没有在内存缓存中找到这张图片。那么它就会委托内部的`OkHttpClient`来加载这张图片。默认情况下它总是会从网络加载图片，因为上文提到的`defaultOkHttpClient`并没有配置缓存响应数据到文件系统。  
+
+指定你自己的`OkHttpClient`可以让你从文件系统中获得缓存的响应数据，而不用每次都从服务端去获取数据。在App完成第一次启动后，这个特性特别重要。这个时候Picasso还没有[内存缓存](http://stackoverflow.com/a/22756972/400717)，所以它会频繁的让`OkHttpClient`去加载图片。   
+
+为了实现上面说的，你只需要用`OkHttpDownloader`对`OkHttpClient`进行包裹，并把它作为参数传给`Picasso.Builder`的`downloader`方法：  
+
+~~~java
+final Picasso picasso = new Picasso.Builder(context)
+    .downloader(new OkHttpDownloader(okHttpClient))
+    .build();
+
+// The client should inject this instance whenever it is needed, but replace the singleton
+// instance just in case.
+Picasso.setSingletonInstance(picasso);
+~~~  
+
+为了在Retrofit 1.9.x中结合`RestAdapter`使用`OkHttpClient`，把`OkHttpClient`包裹在`OkClient`中，再把它作为`RestAdapter.Builder`的`setClient`方法的参数传进去尽可以了：  
+
+~~~java
+restAdapterBuilder.setClient(new OkClient(httpClient));
+~~~
+
+在Retrofit 2.0中就更简单了，直接把`OkHttpClient`作为`Retrofit.Builder`的`client`方法的参数传递进去就行了。   
+
+在可汗学院App中，我们借助[Dagger](http://google.github.io/dagger/)来确保只有一个`OkHttpClient`的实例。这个实例被Picasso和Retrofit共同使用。我们使用`@Singleton`注解为`OkHttpClient`实例创建了一个提供者：  
+
+~~~java
+@Provides
+@Singleton
+public OkHttpClient okHttpClient(final Context context, ...) {
+  final OkHttpClient okHttpClient = new OkHttpClient();
+  configureClient(okHttpClient, ...);
+  return okHttpClient;
+}
+~~~
+
+然后使用Dagger将`OkHttpClient`注入到其他的提供者当中。这些提供者又创建了`RestAdapter`和`Picasso`实例。 
+
+### 4. 指定用户代理拦截器  
+当用户在每个请求里指定一个详细的`User-Agent`请求头的值的时候，日志文件和日志分析就变得更加有用了。默认情况下，OkHttp包含了一个`User-Agent`的请求头，但这个头仅仅标识出了OkHttp的版本信息。你可以创建一个自定义个拦截器来取代这个默认值，以下是[StackOverflow](http://stackoverflow.com/a/27840834/400717)上的一段可供参考的代码:  
+
+~~~java
+public final class UserAgentInterceptor implements Interceptor {
+  private static final String USER_AGENT_HEADER_NAME = "User-Agent";
+  private final String userAgentHeaderValue;
+
+  public UserAgentInterceptor(String userAgentHeaderValue) {
+    this.userAgentHeaderValue = Preconditions.checkNotNull(userAgentHeaderValue);
+  }
+
+  @Override
+  public Response intercept(Chain chain) throws IOException {
+    final Request originalRequest = chain.request();
+    final Request requestWithUserAgent = originalRequest.newBuilder()
+        .removeHeader(USER_AGENT_HEADER_NAME)
+        .addHeader(USER_AGENT_HEADER_NAME, userAgentHeaderValue)
+        .build();
+    return chain.proceed(requestWithUserAgent);
+  }
+}
+~~~    
+
+你可以使用任何你觉得有用的信息作为参数传递到`UserAgentInterceptor`的构造方法中来构造`User-Agent`头的值。我们使用了一下的信息：  
+
+* `Android`系统的`os`值，用它来明确额标识出这是来自Android设备的请求
+* `Build.MODEL`, 或“终端用户可见的产品名称”
+* `Build.BRAND`, 或“消费者可见的产品或者硬件品牌名”
+* `Build.VERSION.SDK_INT`, 或“用户可见的AndroidSDK版本号”
+* `BuildConfig.APPLICATION_ID`
+* `BuildConfig.VERSION_NAME`
+* `BuildConfig.VERSION_CODE`   
+
+最后三个参数我们通过Gradle构建脚本里的`applicationId`, `versionCode`和`versionName`来指定。你可以查看[这里](http://developer.android.com/tools/publishing/versioning.html)和[这里](http://tools.android.com/tech-docs/new-build-system/applicationid-vs-packagename)的文档来获取更多的信息。  
+
+需要注意的是，如果你的App中用到了`WebView`,你可以配置你的WebView使用与`UserAgentInterceptor`的构造参数相同的`User-Agent`的值：  
+
+~~~java
+WebSettings settings = webView.getSettings();
+settings.setUserAgentString(userAgentHeaderValue);
+~~~
+
+### 5. 配置合理的超时时间
+在2.5.0之前，OkHttp的请求默认不会超时。从2.5.0开始，如果一个请求建立连接后从这个连接中读取数据或者向这个连接写入数据超过10秒钟就认为超时。更新到2.5.0之后，我们的代码中出现了一些bug，因为一开始想要确定出错的具体位置。要覆盖这些默认行为，只需要对应的去调用`setConnectTimeout`、`setReadTimeout` 或者 `setWriteTimeout`方法即可。  
+
+需要注意的是Picasso和Retrofit的默认`OkHttpClient`的超时时间是不同的。Picasso的默认值分别是：  
+
+* 连接超时15秒
+* 读数据超时20秒
+* 写数据超时20秒
+
+而Retrofit的默认值是：
+
+* 连接超时15秒
+* 读数据超时20秒
+* 写数据不会超时
+
+你可以使用自定义的`OkHttpClient`来配置Picasso和Retrofit，这样就可以保证所有的请求超时时间都是统一的。  
+
+### 总结
+再次声明，默认的OkHttp的配置方式已经提供了很大的便利。但是通过以上步骤你可以提高它更加高效与智能，从而提升你的App质量。