From 792db44dedc8228a44188aa785af93aa91d49355 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B8=83=E5=85=B0=E6=9F=AF=E5=9F=BA?= Date: Sat, 11 Mar 2017 23:57:01 +0800 Subject: [PATCH 01/51] modify some From 94f38716391ee73b20d1d0c1f47aa898681dbf2e Mon Sep 17 00:00:00 2001 From: Blankj <625783482@qq.com> Date: Mon, 13 Mar 2017 15:59:14 +0800 Subject: [PATCH 02/51] modify some --- README.md | 136 +++++++++++++++++++++++++++--------------------------- 1 file changed, 69 insertions(+), 67 deletions(-) diff --git a/README.md b/README.md index 9355641..0887628 100755 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ 1. 尽量使用最新版的IDE进行开发； 2. 编码格式统一为**UTF-8**； -3. 编辑完`.java`, `.xml`等文件后一定要**格式化**（基本格式方面使用 AS 默认模板即可）； +3. 编辑完`.java`、 `.xml`等文件后一定要**格式化**（基本格式方面使用 AS 默认模板即可）； 4. 删除多余的import，减少警告出现，可利用AS的`Optimize Imports`(Settings → Keymap → Optimize Imports)快捷键； 5. AS常用开发插件可以参考这里～**[AS常用开发插件][AS常用开发插件]** @@ -284,17 +284,23 @@ public class MyClass { 例如： -| 名称 | 说明 | -| ----------------------- | ----- | -| btn_main_home.png | 按键 | -| divider_maket_white.png | 分割线 | -| ic_edit.png | 图标 | -| bg_main.png | 背景 | -| btn_red.png | 红色按键 | -| btn_red_big.png | 红色大按键 | -| ic_head_small.png | 小头像 | -| bg_input.png | 输入框背景 | -| divider_white.png | 白色分割线 | +| 名称 | 说明 | +| ----------------------- | ----------------------- | +| btn_main_home.png | 按键`用途_模块名_逻辑名称` | +| divider_maket_white.png | 分割线`用途_模块名_颜色` | +| ic_edit.png | 图标`用途_逻辑名称` | +| bg_main.png | 背景`用途_逻辑名称` | +| btn_red.png | 红色按键`用途_颜色` | +| btn_red_big.png | 红色大按键`用途_颜色` | +| ic_head_small.png | 小头像`用途_逻辑名称` | +| bg_input.png | 输入框背景`用途_逻辑名称` | +| divider_white.png | 白色分割线`用途_颜色` | +| bg_main_head | 主模块头部背景图片`用途_模块名_逻辑名称` | +| def_search_cell | 默认搜索界面单元图片`用途_模块名_逻辑名称` | +| ic_more_help | 更多帮助图标`用途_逻辑名称` | +| divider_list_line | 列表分割线`用途_逻辑名称` | +| selector_search_ok | 搜索界面确认选择器`用途_模块名_逻辑名称` | +| shape_music_ring | 音乐界面环状图片`用途_模块名_逻辑名称` | 如果有多种形态，如按钮选择器：`btn_xx.xml`(selector) @@ -311,11 +317,6 @@ public class MyClass { | btn_xx_checkable | `state_checkable`可选效果 | | btn_xx_activated | `state_activated`激活的 | | btn_xx_windowfocused | `state_window_focused` | -| bg_head | 背景图片使用`bg_功能_说明` | -| def_search_cell | 默认图片使用`def_功能_说明` | -| ic_more_help | 图标图片使用`ic_功能_说明` | -| seg_list_line | 具有分隔特征的图片使用`seg_功能_说明` | -| sel_ok | 选择图标使用`sel_功能_说明` | > 注意：使用AndroidStudio的插件`SelectorChapek`可以快速生成selector，前提是命名要规范。 @@ -388,6 +389,8 @@ public class MyClass { 向应用设计者那里要这个调色板，名称不需要跟`"green"`、`"blue"`等等相同。`"brand_primary"`、`"brand_secondary"`、`"brand_negative"`这样的名字也是完全可以接受的。 像这样规范的颜色很容易修改或重构，会使应用一共使用了多少种不同的颜色变得非常清晰。 通常一个具有审美价值的UI来说，减少使用颜色的种类是非常重要的。 +> 注意：如果某些颜色和主题有关，那就独立出去写。 + ##### 4.4.2 dimens.xml @@ -661,59 +664,58 @@ public static byte[] bitmap2Bytes(Bitmap bitmap, CompressFormat format) { ### UI控件缩写表 -| 名称 | 缩写 | -| -------------- | ------- | -| TextView | txt | -| EditText | edit | -| Button | btn | -| ImageButton | ibtn | -| ImageView | img | -| ListView | lv | -| RadioGroup | rgroup | -| RadioButton | rbtn | -| ProgressBar | rbar | -| SeekBar | seek | -| CheckBox | cb | -| Spinner | spinner | -| TableLayout | table | -| TableRow | row | -| LinearLayout | ll | -| RelativeLayout | rl | -| ScrollView | scroll | -| SearchView | search | -| TabHost | thost | -| TabWidget | twidget | +| 名称 | 缩写 | +| -------------- | ---- | +| TextView | tv | +| EditText | et | +| ImageButton | ib | +| Button | btn | +| ImageView | iv | +| ListView | lv | +| GridView | gv | +| ProgressBar | pb | +| SeekBar | sb | +| RadioButtion | rb | +| CheckBox | cb | +| ScrollView | sv | +| LinearLayout | ll | +| FrameLayout | fl | +| RelativeLayout | rl | +| RecyclerView | rv | +| WebView | wv | +| VideoView | vv | +| Spinner | spn | +| ToggleButton | tb | ### 常见的英文单词缩写表 -| 名称 | 缩写 | -| -------------------- | ---------------------------------------- | -| icon | ic （主要用在app的图标） | -| color | cl（主要用于颜色值） | -| divider | di（主要用于分隔线，不仅包括Listview中的divider，还包括普通布局中的线） | -| selector | sl（主要用于某一view多种状态，不仅包括Listview中的selector，还包括按钮的selector） | -| average | avg | -| background | bg（主要用于布局和子布局的背景） | -| buffer | buf | -| control | ctrl | -| delete | del | -| document | doc | -| error | err | -| escape | esc | -| increment | inc | -| infomation | info | -| initial | init | -| image | img | -| Internationalization | I18N | -| length | len | -| library | lib | -| message | msg | -| password | pwd | -| position | pos | -| server | srv | -| string | str | -| temp | tmp | -| window | wnd(win) | +| 名称 | 缩写 | +| -------------------- | ----------------- | +| icon | ic （主要用在app的图标） | +| color | cl（主要用于颜色值） | +| average | avg | +| background | bg（主要用于布局和子布局的背景） | +| buffer | buf | +| control | ctrl | +| default | def | +| delete | del | +| document | doc | +| error | err | +| escape | esc | +| increment | inc | +| infomation | info | +| initial | init | +| image | img | +| Internationalization | I18N | +| length | len | +| library | lib | +| message | msg | +| password | pwd | +| position | pos | +| server | srv | +| string | str | +| temp | tmp | +| window | wnd(win) | 程序中使用单词缩写原则：不要用缩写，除非该缩写是约定俗成的。 From d895bd3710e0a07309f8d2840e68c2b9fc2ccfa3 Mon Sep 17 00:00:00 2001 From: Blankj <625783482@qq.com> Date: Mon, 13 Mar 2017 16:29:23 +0800 Subject: [PATCH 03/51] modify some --- README.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 0887628..2120006 100755 --- a/README.md +++ b/README.md @@ -300,7 +300,7 @@ public class MyClass { | ic_more_help | 更多帮助图标`用途_逻辑名称` | | divider_list_line | 列表分割线`用途_逻辑名称` | | selector_search_ok | 搜索界面确认选择器`用途_模块名_逻辑名称` | -| shape_music_ring | 音乐界面环状图片`用途_模块名_逻辑名称` | +| shape_music_ring | 音乐界面环形形状`用途_模块名_逻辑名称` | 如果有多种形态，如按钮选择器：`btn_xx.xml`(selector) @@ -426,7 +426,7 @@ public class MyClass { ##### 4.4.3 strings.xml -`strings`的`name`命名使用下划线命名法，采用以下规则：`模块名+逻辑名称` +`strings`的`name`命名使用下划线命名法，采用以下规则：`模块名+逻辑名称`，这样方便同一个界面的所有string都放到一起，方便查找。 | 名称 | 说明 | | ----------------- | ------- | @@ -441,7 +441,7 @@ public class MyClass { ##### 4.4.4 styles.xml -几乎每个项目都需要适当的使用`style`文件，因为对于一个视图来说有一个重复的外观是很常见的，将所有的外观细节属性（`colors`、`padding`、`font`）放在`style`文件中。 在应用中对于大多数文本内容，最起码你应该有一个通用的`style`文件，例如： +`style`的`name`命名使用大驼峰命名法，几乎每个项目都需要适当的使用`style`文件，因为对于一个视图来说有一个重复的外观是很常见的，将所有的外观细节属性（`colors`、`padding`、`font`）放在`style`文件中。 在应用中对于大多数文本内容，最起码你应该有一个通用的`style`文件，例如： ``` ``` -应用到`TextView`中: +应用到 `TextView` 中： ``` ``` -你或许需要为按钮控件做同样的事情，不要停止在那里。将一组相关的和重复`android:****`的属性放到一个通用的`style`中。 +你或许需要为按钮控件做同样的事情，不要停止在那里。将一组相关的和重复 `android:****` 的属性放到一个通用的 `style` 中。 -**将一个大的`styles.xml`文件分割成多个文件**， 你可以有多个`styles.xml` 文件。Android SDK支持其它文件，`styles.xml`这个文件名称并没有作用，起作用的是在文件里的` ``` -应用到 `TextView` 中： +应用到`TextView`中: ``` ``` -你或许需要为按钮控件做同样的事情，不要停止在那里。将一组相关的和重复 `android:****` 的属性放到一个通用的 `style` 中。 +你或许需要为按钮控件做同样的事情，不要停止在那里。将一组相关的和重复`android:****`的属性放到一个通用的`style`中。 -** 将一个大的 `styles.xml` 文件分割成多个文件 **， 你可以有多个 `styles.xml` 文件。Android SDK 支持其它文件，`styles.xml` 这个文件名称并没有作用，起作用的是在文件里的 ` ``` -应用到`TextView`中: +应用到 `TextView` 中： ``` ``` -你或许需要为按钮控件做同样的事情，不要停止在那里。将一组相关的和重复`android:****`的属性放到一个通用的`style`中。 +你或许需要为按钮控件做同样的事情，不要停止在那里。将一组相关的和重复 `android:****` 的属性放到一个通用的 `style` 中。 -**将一个大的`styles.xml`文件分割成多个文件**， 你可以有多个`styles.xml` 文件。Android SDK支持其它文件，`styles.xml`这个文件名称并没有作用，起作用的是在文件里的`