阿里Android规范-02-必须遵守整理

作者: zhongcx | 来源:发表于2020-04-28 08:47 被阅读0次

阿里Android规范-02-必须遵守整理
Android组开发规范-参考95%参考阿里
Android 开发规范
python编程规范
Android 代码命名规范
如何统一代码风格？
开发规范
阿里Java规范-02-异常日志
规范问题
android知识点—阿里内部Android规范文档(转)

三、Android基本组件

1、【强制】Activity间的数据通信，对于数据量比较大的，避免使用Intent + Parcelable 的方式，可以考虑EventBus等替代方案，以免造成TransactionTooLargeException。

【强制】Activity间通过隐式Intent的跳转，在发出Intent之前必须通过resolveActivity 检查，避免找不到合适的调用组件，造成ActivityNotFoundException 的异常。

正例：

public void viewUrl(String url, String mimeType) { 
    Intent intent = new Intent(Intent.ACTION_VIEW); 
    intent.setDataAndType(Uri.parse(url), mimeType); 
    if (getPackageManager().resolveActivity(intent, PackageManager.MATCH_DEFAULT_ ONLY) != null) { 
        startActivity(intent); 
       }else { 
       // 找不到指定的Activity 
    } 
}

反例：

Intent intent = new Intent(); 
intent.setAction("com.example.DemoIntent "); 
try { 
    startActivity(intent); 
} catch (ActivityNotFoundException e) { 
    e.printStackTrace(); 
}

【强制】避免在Service#onStartCommand()/onBind()方法中执行耗时操作，如果确实有需求，应改用IntentService或采用其他异步机制完成。

正例：

public class MainActivity extends Activity { 
    @Override 
    public void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.main); 
    } 
 
    public void startIntentService(View source) { 
        Intent intent = new Intent(this, MyIntentService.class); 
        startService(intent); 
    } 
} 
 
public class MyIntentService extends IntentService { 
    public MyIntentService() { 
        super("MyIntentService"); 
    } 
 
    @Override 
    protected void onHandleIntent(Intent intent) { 
        synchronized (this) { 
            try { 
                ...... 
            } catch (Exception e) { 
            } 
        } 
    } 
}

【强制】避免在BroadcastReceiver#onReceive()中执行耗时操作，如果有耗时工作，应该创建IntentService 完成，而不应该在BroadcastReceiver 内创建子线程去做。
说明：
由于该方法是在主线程执行，如果执行耗时操作会导致 UI 不流畅。可以使用 IntentService 、创建 HandlerThread 或者调用 Context#registerReceiver (BroadcastReceiver, IntentFilter, String, Handler)方法等方式，在其他Wroker线程执行 onReceive 方法。BroadcastReceiver#onReceive()方法耗时超过 10 秒钟，可能会被系统杀死。
正例：

IntentFilter filter = new IntentFilter(); 
filter.addAction(LOGIN_SUCCESS); 
this.registerReceiver(mBroadcastReceiver, filter);  
mBroadcastReceiver = new BroadcastReceiver() { 
    @Override 
    public void onReceive(Context context, Intent intent) { 
        Intent userHomeIntent = new Intent(); 
        userHomeIntent.setClass(this, UserHomeService.class); 
        this.startService(userHomeIntent); 
    } 
};

反例：

mBroadcastReceiver = new BroadcastReceiver() { 
    @Override 
    public void onReceive(Context context, Intent intent) { 
       MyDatabaseHelper myDB = new MyDatabaseHelper(context); 
       myDB.initData(); 
       // have more database operation here 
    } 
};

【强制】避免使用隐式 Intent 广播敏感信息，信息可能被其他注册了对应 BroadcastReceiver的App接收。
说明：
通过Context#sendBroadcast()发送的隐式广播会被所有感兴趣的receiver接收，恶意应用注册监听该广播的 receiver 可能会获取到 Intent 中传递的敏感信息，并进行其他危险操作。如果发送的广播为使用 Context#sendOrderedBroadcast()方法发送的有序广播，优先级较高的恶意 receiver 可能直接丢弃该广播，造成服务不可用，或者向广播结果塞入恶意数据。
如果广播仅限于应用内，则可以使用 LocalBroadcastManager#sendBroadcast()实现，避免敏感信息外泄和Intent拦截的风险。

正例：

Intent intent = new Intent("my-sensitive-event"); 
intent.putExtra("event", "this is a test event"); 
LocalBroadcastManager.getInstance(this).sendBroadcast(intent);

反例：

Intent intent = new Intent(); 
v1.setAction("com.sample.action.server_running"); 
v1.putExtra("local_ip", v0.h); 
v1.putExtra("port", v0.i); 
v1.putExtra("code", v0.g); 
v1.putExtra("connected", v0.s); 
v1.putExtra("pwd_predefined", v0.r); 
if (!TextUtils.isEmpty(v0.t)) { 
    v1.putExtra("connected_usr", v0.t); 
} 
context.sendBroadcast(v1);

以上广播可能被其他应用的如下receiver接收导致敏感信息泄漏

final class MyReceiver extends BroadcastReceiver { 
    public final void onReceive(Context context, Intent intent) { 
        if (intent != null && intent.getAction() != null) { 
            String s = intent.getAction(); 
            if (s.equals("com.sample.action.server_running") { 
                String ip = intent.getStringExtra("local_ip"); 
                String pwd = intent.getStringExtra("code"); 
                String port = intent.getIntExtra("port", 8888); 
                boolean status = intent.getBooleanExtra("connected", false); 
            } 
        } 
    } 
}

【强制】Activity或者Fragment中动态注册BroadCastReceiver时，registerReceiver() 和unregisterReceiver()要成对出现。
说明：
如果registerReceiver()和unregisterReceiver()不成对出现，则可能导致已经注册的 receiver没有在合适的时机注销，导致内存泄漏，占用内存空间，加重SystemService 负担。
部分华为的机型会对 receiver 进行资源管控，单个应用注册过多 receiver 会触发管控模块抛出异常，应用直接崩溃。

正例：

public class MainActivity extends AppCompatActivity { 
    private static MyReceiver myReceiver = new MyReceiver(); 
    ... 
    @Override 
    protected void onResume() { 
        super.onResume(); 
        IntentFilter filter = new IntentFilter("com.example.myservice"); 
        registerReceiver(myReceiver, filter); 
} 
 
    @Override 
    protected void onPause() { 
        super.onPause(); 
        unregisterReceiver(myReceiver); 
    } 
    ... 
}

反例：

public class MainActivity extends AppCompatActivity { 
private static MyReceiver myReceiver; 
 
    @Override 
    protected void onResume() { 
        super.onResume(); 
        myReceiver = new MyReceiver(); 
        IntentFilter filter = new IntentFilter("com.example.myservice"); 
        registerReceiver(myReceiver, filter); 
    } 
 
    @Override 
    protected void onDestroy() { 
        super.onDestroy(); 
        unregisterReceiver(myReceiver); 
    } 
}

Activity 的生命周期不对应，可能出现多次 onResume 造成 receiver 注册多个，但终只注销一个，其余receiver产生内存泄漏。
15.【强制】Android 基础组件如果使用隐式调用，应在 AndroidManifest.xml 中使用 <intent-filter> 或在代码中使用 IntentFilter 增加过滤。
说明：
如果浏览器支持Intent Scheme Uri语法，如果过滤不当，那么恶意用户可能通过浏览器 js 代码进行一些恶意行为，比如盗取 cookie 等。如果使用了 Intent.parseUri 函数，获取的intent必须严格过滤。

正例：

// 将 intent scheme URL 转换为 intent 对象 
Intent intent = Intent.parseUri(uri);   
// 禁止没有 BROWSABLE category 的情况下启动activity 
intent.addCategory("android.intent.category.BROWSABLE");   
intent.setComponent(null);   
intent.setSelector(null);   
// 使用 intent 启动 activity 
context.startActivityIfNeeded(intent, -1)

反例：

Intent intent = Intent.parseUri(uri.toString().trim().substring(15), 0); 
intent.addCategory("android.intent.category.BROWSABLE"); 
context.startActivity(intent);

四、UI与布局

【强制】布局中不得不使用 ViewGroup 多重嵌套时，不要使用 LinearLayout 嵌套，改用RelativeLayout，可以有效降低嵌套数。
说明：
Android 应用页面上任何一个 View 都需要经过 measure、layout、draw 三个步骤才能被正确的渲染。从xml layout的顶部节点开始进行measure，每个子节点都需要向自己的父节点提供自己的尺寸来决定展示的位置，在此过程中可能还会重新 measure（由此可能导致measure的时间消耗为原来的2-3倍）。节点所处位置越深，嵌套带来的 measure 越多，计算就会越费时。这就是为什么扁平的 View 结构会性能更好。
同时，页面拥上的View越多，measure、layout、draw所花费的时间就越久。要缩短这个时间，关键是保持View的树形结构尽量扁平，而且要移除所有不需要渲染的 View。理想情况下，总共的measure，layout，draw时间应该被很好的控制在16ms 以内，以保证滑动屏幕时UI的流畅。
要找到那些多余的 View（增加渲染延迟的 view），可以用 Android Studio Monitor 里的Hierarchy Viewer工具，可视化的查看所有的view。
【强制】禁止在非UI线程进行View相关操作。
【强制】禁止在设计布局时多次为子 View 和父 View 设置同样背景进而造成页面过度绘制，推荐将不需要显示的布局进行及时隐藏。

正例：

<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 
    android:orientation="vertical" > 
<TextView 
    android:layout_width="match_parent" 
    android:layout_height="wrap_content" 
    android:text="@string/hello" /> 
<Button  
    android:id="@+id/btn_mybuttom"
    android:layout_width="match_parent" 
    android:layout_height="wrap_content" 
    android:text="click it !" /> 
<ImageView  
    android:id="@+id/img" 
    android:layout_width="match_parent" 
    android:layout_height="wrap_content" 
    android:visibility="gone" 
    android:src="@drawable/youtube" /> 
<TextView  
    android:text="it is an example!" 
    android:layout_width="match_parent" 
    android:layout_height="wrap_content" /> 
</LinearLayout>

反例：

@Override 
protected void onDraw(Canvas canvas) { 
    super.onDraw(canvas); 
    int width = getWidth(); 
    int height = getHeight(); 
    mPaint.setColor(Color.GRAY); 
    canvas.drawRect(0, 0, width, height, mPaint); 
    mPaint.setColor(Color.CYAN); 
    canvas.drawRect(0, height/4, width, height, mPaint); 
    mPaint.setColor(Color.DKGRAY); 
    canvas.drawRect(0, height/3, width, height, mPaint); 
    mPaint.setColor(Color.LTGRAY); 
    canvas.drawRect(0, height/2, width, height, mPaint); 
}

11.【强制】不能使用 ScrollView 包裹 ListView/GridView/ExpandableListVIew;因为这样会把 ListView 的所有 Item 都加载到内存中，要消耗巨大的内存和 cpu 去绘制图面。
说明：
ScrollView中嵌套List或RecyclerView的做法官方明确禁止。除了开发过程中遇到的各种视觉和交互问题，这种做法对性能也有较大损耗。ListView等UI组件自身有垂直滚动功能，也没有必要在嵌套一层ScrollView。目前为了较好的UI体验，更贴近Material Design的设计，推荐使用NestedScrollView。

正例：

<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout> 
    <android.support.v4.widget.NestedScrollView> 
        <LinearLayout> 
            <ImageView/> 
            ... 
            <android.support.v7.widget.RecyclerView/> 
        </LinearLayout> 
    </android.support.v4.widget.NestedScrollView> 
</LinearLayout>

反例：

<ScrollView> 
    <LinearLayout> 
        <TextView/> 
        ... 
        <ListView/> 
        <TextView /> 
    </LinearLayout> 
</ScrollView>

12.【强制】不要在 Android 的 Application 对象中缓存数据。基础组件之间的数据共享请使用Intent等机制，也可使用SharedPreferences等数据持久化机制。

反例：

class MyApplication extends Application { 
String username; 
 
    String getUsername() { 
        return username; 
} 
 
    void setUsername(String username) { 
        this.username = username; 
    } 
} 
 
class SetUsernameActivity extends Activity { 
    void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.set_username); 
        MyApplication app = (MyApplication) getApplication(); 
        app.setUsername("tester1"); 
        startActivity(new Intent(this, GetUsernameActivity.class)); 
    } 
} 
 
class GetUsernameActivity extends Activity { 
TextView tv; 
 
@Override 
    void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.get_username); 
        tv = (TextView)findViewById(R.id.username); 
} 
 
@Override 
    void onResume() { 
        super.onResume(); 
        MyApplication app = (MyApplication) getApplication(); 
        tv.setText("Welcome back ! " + app.getUsername().toUpperCase()); 
    } 
}

14.【强制】使用 Adapter 的时候，如果你使用了 ViewHolder 做缓存，在 getView()的方法中无论这项 convertView 的每个子控件是否需要设置属性(比如某个 TextView 设置的文本可能为 null，某个按钮的背景色为透明，某控件的颜色为透明等)，都需要为其显式设置属性(Textview的文本为空也需要设置setText("")，背景透明也需要设置)，否则在滑动的过程中，因为adapter item复用的原因，会出现内容的显示错乱。

正例：

@Override   
public View getView(int position, View convertView, ViewGroup parent) { 
    ViewHolder myViews; 
    if (convertView == null) { 
        myViews = new ViewHolder(); 
        convertView = mInflater.inflate(R.layout.list_item, null); 
        myViews.mUsername = (TextView)convertView.findViewById(R.id.username); 
        convertView.setTag(myViews); 
    } else { 
        myViews = (ViewHolder)convertView.getTag(); 
    } 
    Info p = infoList.get(position); 
    String dn = p.getDisplayName; 
    myViews.mUsername.setText(StringUtils.isEmpty(dn) ? "" : dn); 
    return convertView; 
} 
 
static class ViewHolder { 
    private TextView mUsername; 
}

五、进程、线程与消息通信

【强制】不要通过 Intent 在 Android 基础组件之间传递大数据（binder transaction 缓存为1MB），可能导致OOM。
【强制】在 Application 的业务初始化代码加入进程判断，确保只在自己需要的进程初始化。特别是后台进程减少不必要的业务初始化。

正例：

public class MyApplication extends Application { 
    @Override 
    public void onCreate() { 
        //在所有进程中初始化 
        .... 
        //仅在主进程中初始化 
        if (mainProcess) { 
        ... 
        }  
        //仅在后台进程中初始化 
        if (bgProcess) { 
            ... 
        } 
    } 
}

【强制】新建线程时，必须通过线程池提供（AsyncTask 或者 ThreadPoolExecutor 或者其他形式自定义的线程池），不允许在应用中自行显式创建线程。
说明：
使用线程池的好处是减少在创建和销毁线程上所花的时间以及系统资源的开销，解决资源不足的问题。如果不使用线程池，有可能造成系统创建大量同类线程而导致消耗完内存或者“过度切换”的问题。另外创建匿名线程不便于后续的资源使用分析，对性能分析等会造成困扰。

正例：

int NUMBER_OF_CORES = Runtime.getRuntime().availableProcessors(); 
int KEEP_ALIVE_TIME = 1; 
TimeUnit KEEP_ALIVE_TIME_UNIT = TimeUnit.SECONDS; 
BlockingQueue<Runnable> taskQueue = new LinkedBlockingQueue<Runnable>(); 
ExecutorService executorService = new ThreadPoolExecutor(NUMBER_OF_CORES,  
NUMBER_OF_CORES*2, KEEP_ALIVE_TIME, KEEP_ALIVE_TIME_UNIT, taskQueue,  
new BackgroundThreadFactory(), new DefaultRejectedExecutionHandler()); 
//执行任务 
executorService.execute(new Runnnable() { 
    ... 
});

反例：

new Thread(new Runnable() { 
    @Override 
    public void run() { 
        //操作语句 
        ... 
    } 
}).start();

【强制】线程池不允许使用Executors去创建，而是通过ThreadPoolExecutor的方式，这样的处理方式让写的同学更加明确线程池的运行规则，规避资源耗尽的风险。
说明：
Executors返回的线程池对象的弊端如下：

FixedThreadPool 和 SingleThreadPool ：允许的请求队列长度Integer.MAX_VALUE，可能会堆积大量的请求，从而导致OOM；
CachedThreadPool 和 ScheduledThreadPool：允许的创建线程数量为 Integer.MAX_VALUE，可能会创建大量的线程，从而导致OOM。

正例：

int NUMBER_OF_CORES = Runtime.getRuntime().availableProcessors(); 
int KEEP_ALIVE_TIME = 1; 
TimeUnit KEEP_ALIVE_TIME_UNIT = TimeUnit.SECONDS; 
BlockingQueue<Runnable> taskQueue = new LinkedBlockingQueue<Runnable>(); 
ExecutorService executorService = new ThreadPoolExecutor(NUMBER_OF_CORES,  
NUMBER_OF_CORES*2, KEEP_ALIVE_TIME, KEEP_ALIVE_TIME_UNIT,  
taskQueue, new BackgroundThreadFactory(), new DefaultRejectedExecutionHandler());

反例：

ExecutorService cachedThreadPool = Executors.newCachedThreadPool();

【强制】子线程中不能更新界面，更新界面必须在主线程中进行，网络操作不能在主线程中调用。

六、文件与数据库

【强制】任何时候不要硬编码文件路径，请使用Android文件系统API访问。
说明：
Android 应用提供内部和外部存储，分别用于存放应用自身数据以及应用产生的用户数据。可以通过相关API接口获取对应的目录，进行文件操作。

android.os.Environment#getExternalStorageDirectory() 
android.os.Environment#getExternalStoragePublicDirectory() 
android.content.Context#getFilesDir() 
android.content.Context#getCacheDir

正例：

public File getDir(String alName) { 
    File file = new File(Environment.getExternalStoragePublicDirectory(Environment. DIRECTORY_PICTURES), alName); 
    if (!file.mkdirs()) { 
        Log.e(LOG_TAG, "Directory not created"); 
    } 
    return file; 
}

反例：

public File getDir(String alName) { 
    // 任何时候都不要硬编码文件路径，这不仅存在安全隐患，也让 app更容易出现适配问题  
    File file = new File("/mnt/sdcard/Download/Album", alName); 
    if (!file.mkdirs()) { 
        Log.e(LOG_TAG, "Directory not created"); 
    } 
    return file; 
}

【强制】当使用外部存储时，必须检查外部存储的可用性。

正例：

// 读/写检查  
public boolean isExternalStorageWritable() { 
    String state = Environment.getExternalStorageState(); 
    if (Environment.MEDIA_MOUNTED.equals(state)) { 
        return true; 
    } 
    return false; 
} 
// 只读检查  
public boolean isExternalStorageReadable() { 
    String state = Environment.getExternalStorageState(); 
    if (Environment.MEDIA_MOUNTED_READ_ONLY.equals(state)) { 
        return true; 
    } 
    return false; 
}

【强制】应用间共享文件时，不要通过放宽文件系统权限的方式去实现，而应使用 FileProvider。

正例：

<!-- AndroidManifest.xml --> 
<manifest> 
    ... 
    <application> 
    ... 
    <provider 
        android:name="android.support.v4.content.FileProvider" 
       android:authorities="com.example.fileprovider" 
       android:exported="false" 
       android:grantUriPermissions="true"> 
       <meta-data 
            android:name="android.support.FILE_PROVIDER_PATHS" 
            android:resource="@xml/provider_paths" /> 
    </provider> 
    ... 
    </application> 
</manifest> 
<!-- res/xml/provider_paths.xml --> 
<paths> 
    <files-path path="album/" name="myimages" /> 
</paths> 
void getAlbumImage(String imagePath) { 
    File image = new File(imagePath); 
    Intent getAlbumImageIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); 
    Uri imageUri = FileProvider.getUriForFile( 
            this, 
            "com.example.provider", 
            image); 
    getAlbumImageIntent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri); 
    startActivityForResult(takePhotoIntent, REQUEST_GET_ALBUMIMAGE); 
}

反例：

void getAlbumImage(String imagePath) { 
    File image = new File(imagePath); 
    Intent getAlbumImageIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); 
    //不要使用file://的 URI 分享文件给别的应用，包括但不限于 Intent  
    getAlbumImageIntent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(image)); 
    startActivityForResult(takePhotoIntent, REQUEST_GET_ALBUMIMAGE); 
}

【强制】数据库Cursor必须确保使用完后关闭，以免内存泄漏。
说明：
Cursor 是对数据库查询结果集管理的一个类，当查询的结果集较小时，消耗内存不易察觉。但是当结果集较大，长时间重复操作会导致内存消耗过大，需要开发者在操作完成后手动关闭Cursor。
数据库Cursor在创建及使用时，可能发生各种异常，无论程序是否正常结束，必须在后确保 Cursor 正确关闭，以避免内存泄漏。同时，如果 Cursor 的使用还牵涉多线程场景，那么需要自行保证操作同步。

正例：

public void handlePhotos(SQLiteDatabase db, String userId) { 
    Cursor cursor; 
    try { 
        cursor = db.query(TUserPhoto, new String[] { "userId", "content" }, "userId=?", new String[] { userId }, null, null, null); 
        while (cursor.moveToNext()) { 
            // TODO  
        } 
    } catch (Exception e) { 
        // TODO  
    } finally { 
        if (cursor != null) { 
            cursor.close(); 
        } 
    } 
}

反例：

public void handlePhotos(SQLiteDatabase db, String userId) { 
    Cursor cursor = db.query(TUserPhoto, new String[] { "userId", "content" }, "userId=?", new String[] { userId }, null, null, null); 
    while (cursor.moveToNext()) { 
        // TODO  
    } 
    // 不能放任 cursor 不关闭  
}

【强制】多线程操作写入数据库时，需要使用事务，以免出现同步问题。
说明：
通过 SQLiteOpenHelper 获取数据库 SQLiteDatabase 实例，Helper 中会自动缓存已经打开的 SQLiteDatabase 实例，单个 App 中应使用 SQLiteOpenHelper 的单例模式确保数据库连接唯一。由于SQLite自身是数据库级锁，单个数据库操作是保证线程安全的（不能同时写入），transaction是一次原子操作，因此处于事务中的操作是线程安全的。
若同时打开多个数据库连接，并通过多线程写入数据库，会导致数据库异常，提示数据库已被锁住。

正例：

public void insertUserPhoto(SQLiteDatabase db, String userId, String content) { 
    ContentValues cv = new ContentValues(); 
    cv.put("userId", userId); 
    cv.put("content", content); 
    db.beginTransaction(); 
    try { 
        db.insert(TUserPhoto, null, cv); 
        // 其他操作  
        db.setTransactionSuccessful(); 
    } catch (Exception e) { 
        // TODO  
    } finally { 
        db.endTransaction(); 
    } 
}

反例：

public void insertUserPhoto(SQLiteDatabase db, String userId, String content) { 
    ContentValues cv = new ContentValues(); 
    cv.put("userId", userId); 
    cv.put("content", content); 
    db.insert(TUserPhoto, null, cv); 
}

【强制】执行 SQL 语句时，应使用 SQLiteDatabase#insert()、update()、delete()，不要使用SQLiteDatabase#execSQL()，以免SQL注入风险。

正例：

public int updateUserPhoto(SQLiteDatabase db, String userId, String content) { 
    ContentValues cv = new ContentValues(); 
    cv.put("content", content); 
    String[] args = {String.valueOf(userId)}; 
    return db.update(TUserPhoto, cv, "userId=?", args); 
}

反例：

public void updateUserPhoto(SQLiteDatabase db, String userId, String content) { 
    String sqlStmt = String.format("UPDATE %s SET content=%s WHERE userId=%s", TUserPhoto, userId, content); 
    //请提高安全意识，不要直接执行字符串作为SQL 语句  
    db.execSQL(sqlStmt); 
}

10.【强制】如果 ContentProvider 管理的数据存储在 SQL 数据库中，应该避免将不受信任的外部数据直接拼接在原始SQL语句中。

正例：

// 使用一个可替换参数 
String mSelectionClause =  "var = ?"; 
String[] selectionArgs = {""}; 
selectionArgs[0] = mUserInput;

反例：

// 拼接用户输入内容和列名 
String mSelectionClause =  "var = " + mUserInput;

七、Bitmap、Drawable与动画

【强制】加载大图片或者一次性加载多张图片，应该在异步线程中进行。图片的加载，涉及到IO操作，以及CPU密集操作，很可能引起卡顿。

正例：

class BitmapWorkerTask extends AsyncTask<Integer, Void, Bitmap> { 
    ... 
    // 在后台进行图片解码 
    @Override 
    protected Bitmap doInBackground(Integer... params) { 
        final Bitmap bitmap = BitmapFactory.decodeFile("some path"); 
        return bitmap; 
    } 
    ... 
}

反例：

Button btnLoadImage = (Button) findViewById(R.id.btn); 
btnLoadImage.setOnClickListener(new OnClickListener(){ 
    public void onClick(View v) { 
        Bitmap bitmap = BitmapFactory.decodeFile("some path"); 
    } 
});

【强制】在ListView，ViewPager，RecyclerView，GirdView等组件中使用图片时，应做好图片的缓存，避免始终持有图片导致内存溢出，也避免重复创建图片，引起性能问题。建议使用 Fresco（https://github.com/facebook/fresco ）、Glide （https://github.com/bumptech/glide）等图片库。

正例：
例如使用系统LruCache缓存，参考： https://developer.android.com/topic/performance/graphics/cache-bitmap.html

private LruCache<String, Bitmap> mMemoryCache; 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
    ... 
    // 获取可用内存的大值，使用内存超出这个值将抛出 OutOfMemory异常。LruCache 通 过构造函数传入缓存值，以 KB 为单位。  
    final int maxMemory = (int) (Runtime.getRuntime().maxMemory() / 1024); 
    // 把大可用内存的1/8 作为缓存空间 
    final int cacheSize = maxMemory / 8; 
    mMemoryCache = new LruCache<String, Bitmap>(cacheSize) { 
        @Override 
        protected int sizeOf(String key, Bitmap bitmap) { 
            return bitmap.getByteCount() / 1024; 
        } 
    }; 
    ... 
} 
 
public void addBitmapToMemoryCache(String key, Bitmap bitmap) { 
    if (getBitmapFromMemCache(key) == null) { 
        mMemoryCache.put(key, bitmap); 
    } 
} 
 
public Bitmap getBitmapFromMemCache(String key) { 
    return mMemoryCache.get(key); 
} 

public void loadBitmap(int resId, ImageView imageView) { 
    final String imageKey = String.valueOf(resId); 
    final Bitmap bitmap = getBitmapFromMemCache(imageKey); 
    if (bitmap != null) { 
        mImageView.setImageBitmap(bitmap); 
    } else { 
        mImageView.setImageResource(R.drawable.image_placeholder); 
        BitmapWorkerTask task = new BitmapWorkerTask(mImageView); 
        task.execute(resId); 
    } 
} 
 
class BitmapWorkerTask extends AsyncTask<Integer, Void, Bitmap> { 
    ... 
    // 在后台进行图片解码  
    @Override 
    protected Bitmap doInBackground(Integer... params) { 
        final Bitmap bitmap = decodeSampledBitmapFromResource(getResources(), params[0], 100, 100)); 
        addBitmapToMemoryCache(String.valueOf(params[0]), bitmap); 
        return bitmap; 
        } 
    ... 
}

反例：
没有存储，每次都需要解码，或者有缓存但是没有合适的淘汰机制，导致缓存效果很差，依然经常需要重新解码。

【强制】png图片使用TinyPNG或者类似工具压缩处理，减少包体积。
【强制】使用完毕的图片，应该及时回收，释放宝贵的内存。

正例：

Bitmap bitmap = null; 
loadBitmapAsync(new OnResult(result){ 
    bitmap = result; 
}); 
...使用该 bitmap... 
// 使用结束，在 2.3.3及以下需要调用 recycle()函数，在 2.3.3以上 GC 会自动管理，除非你明 确不需要再用。 
if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.GINGERBREAD_MR1) { 
    bitmap.recycle(); 
} 
bitmap = null;

反例：
使用完成图片，始终不释放资源。

【强制】在Activity#onPause()或Activity#onStop()回调中，关闭当前activity正在执行的的动画。

正例：

public class MyActivity extends Activity { 
    ImageView mImageView; 
    Animation mAnimation; 
    Button mBtn; 
 
    @Override 
    public void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.main); 
        mImageView = (ImageView)findViewById(R.id.ImageView01); 
        mAnimation = AnimationUtils.loadAnimation(this, R.anim.anim); 
        mBtn= (Button)findViewById(R.id.Button01); 
        mBtn.setOnClickListener(new View.OnClickListener() { 
            @Override 
            public void onClick(View v) { 
                mImageView.startAnimation(mAnimation); 
            } 
        }); 
} 

 
@Override 
    public void onPause() { 
        //页面退出，及时清理动画资源  
        mImageView.clearAnimation() 
    } 
}

反例：
页面退出时，不关闭该页面相关的动画。

八、安全

【强制】禁止使用常量初始化矢量参数构建 IvParameterSpec，建议 IV 通过随机方式产生。
说明：
使用常量初始化向量，密码文本的可预测性会高得多，容易受到字典式攻击。iv 的作用主要是用于产生密文的第一个block，以使终生成的密文产生差异（明文相同的情况下），使密码攻击变得更为困难。

正例：

byte[] rand = new byte[16]; 
SecureRandom r = new SecureRandom(); 
r.nextBytes(rand); 
IvParameterSpec iv = new IvParameterSpec(rand);

反例：

IvParameterSpec iv_ = new IvParameterSpec("1234567890".getBytes()); 
System.out.println(iv.getIV());

【强制】将android:allowbackup属性必须设置为false，阻止应用数据被导出。
说明：
android:allowBackup 原本是 Android 提供的 adb 调试功能，如果设置为 true，可以导出应用数据备份并在任意设备上恢复。这对应用安全性和用户数据隐私构成极大威胁，所以必须设置为 false，防止数据泄露。

正例：

<application  
    android:allowBackup="false" 
    android:largeHeap="true" 
    android:icon="@drawable/test_launcher" 
    android:label="@string/app_name" 
    android:theme="@style/AppTheme" >

【强制】如果使用自定义HostnameVerifier实现类，必须在verify()方法中校验服务器主机名的合法性，否则可能受到中间人攻击。
说明：
在与服务器建立 https 连接时，如果 URL 的主机名和服务器的主机名不匹配，则可通过该回调接口来判断是否应该允许建立连接。如果回调内实现不恰当，没有有效校验主机名，甚至默认接受所有主机名，会大大增加安全风险。

反例：

HostnameVerifier hnv = new HostnameVerifier() { 
@Override 
public boolean verify(String hostname, SSLSession session) { 
    // 不做校验，接受任意域名服务器  
    return true; 
    } 
}; 
HttpsURLConnection.setDefaultHostnameVerifier(hnv);

【强制】如果使用自定义X509TrustManager实现类，必须在checkServerTrusted() 方法中校验服务端证书的合法性，否则可能受到中间人攻击。
说明：
常见误区是checkServerTrusted()方法根本没有实现，这将导致 X509TrustManager 形同虚设。该方法中需要实现完备的校验逻辑，对于证书错误抛出
CertificateException 。

正例：

HostnameVerifier hnv = new HostnameVerifier() { 
    @Override 
    public boolean verify(String hostname, SSLSession session) { 
        if("yourhostname".equals(hostname)){   
        return true;   
        } else {   
            HostnameVerifier hv = HttpsURLConnection.getDefaultHostnameVerifier(); 
            return hv.verify(hostname, session); 
        } 
    } 
};

反例：

TrustManager tm = new X509TrustManager() { 
    public void checkClientTrusted(X509Certificate[] chain, String authType) 
    throws CertificateException { 
        //do nothing，接受任意客户端证书  
} 
 
    public void checkServerTrusted(X509Certificate[] chain, String authType) 
    throws CertificateException { 
        //do nothing，接受任意服务端证书  
} 
 
    public X509Certificate[] getAcceptedIssuers() { 
        return null; 
    } 
}; 
sslContext.init(null, new TrustManager[] { tm }, null);

【强制】在 SDK 支持的情况下，Android 应用必须使用 V2 签名，这将对 APK 文件的修改做更多的保护。
【强制】所有的 Android 基本组件（Activity、Service、BroadcastReceiver、ContentProvider等）都不应在没有严格权限控制的情况下，将 android:exported 设置为 true。
【强制】WebView 应设置 WebView#getSettings()#setAllowFileAccess(false)、 WebView#getSettings()#setAllowFileAccessFromFileURLs(false) 、 WebView#getSettings()#setAllowUniversalAccessFromFileURLs(false)，阻止 file scheme URL 的访问。

8.【强制】不要把敏感信息打印到log中。
说明：
在开发过程中，为了方便调试，通常会使用 log 函数输出一些关键流程的信息，这些信息中通常会包含敏感内容，让攻击者更加容易了解APP内部结构，方便破解和攻击，甚至直接获取到有价值的敏感信息。

反例：

String username = "log_leak"; 
String password = "log_leak_pwd"; 
Log.d("MY_APP", "usesname" + username); 
Log.v("MY_APP", "send message to server ");

以上代码使用Log.d Log.v打印程序的执行过程的username等调试信息，日志没有关闭，攻击者可以直接从Logcat中读取这些敏感信息。所以在产品的线上版本中关闭调试接口，不要输出敏感信息。
9.【强制】确保应用发布版本的android:debuggable属性设置为false。
10.【强制】本地加密秘钥不能硬编码在代码中，更不能使用 SharedPreferences 等本地持久化机制存储。应选择 Android 自身的秘钥库（KeyStore）机制或者其他安全性更高的安全解决方案保存。
说明：
应用程序在加解密时，使用硬编码在程序中的密钥，攻击者通过反编译拿到密钥可以轻易解密APP通信数据。
12.【强制】使用Android的AES/DES/DESede加密算法时，不要使用ECB加密模式，应使用CBC或CFB加密模式。
说明：
加密模式有 ECB、CBC、CFB、OFB 等，其中 ECB 的安全性较弱，如果使用固定的密钥，相同的明文将会生成相同的密文，容易受到字典攻击，建议使用 CBC、 CFB 或OFB 等模式。

ECB：Electronic codebook，电子密码本模式
CBC：Cipher-block chaining，密码分组链接模式
CFB：Cipher feedback，密文反馈模式
OFB：Output feedback，输出反馈模式

13.【强制】Android APP在HTTPS通信中，验证策略需要改成严格模式。
说明：
Android APP在HTTPS通信中，使用ALLOW_ALL_HOSTNAME_VERIFIER，表示允许和所有的HOST建立SSL通信，这会存在中间人攻击的风险，终导致敏感信息可能会被劫持，以及其他形式的攻击。

反例：

SSLSocketFactory sf = new MySSLSocketFactory(trustStore); 
sf.setHostnameVerifier(SSLSocketFactory.ALLOW_ALL_HOSTNAME_VERIFIER);

ALLOW_ALL_HOSTNAME_VERIFIER 关闭 host 验证，允许和所有的 host 建立 SSL 通信，BROWSER_COMPATIBLE_HOSTNAME_VERIFIER 和浏览器兼容的验证策略，即通配符能够匹配所有子域名，STRICT_HOSTNAME_VERIFIER 严格匹配模式，hostname 必须匹配第一个 CN 或者任何一个 subject-alts，以上例子使用了 ALLOW_ALL_HOSTNAME_VERIFIER，需要改成 STRICT_HOSTNAME_ VERIFIER。

九、其他

【强制】不能使用System.out.println打印log。

正例：

Log.d(TAG, "Some Android Debug info ...");

反例：

System.out.println("System out println ...");

【强制】Log的tag不能是" "。
说明：
日志的tag是空字符串没有任何意义，也不利于过滤日志。

正例：

private static String TAG = "LoginActivity"; 
Log.e(TAG, "Login failed!");

反例：

Log.e("", "Login failed!");

阿里Android规范-02-必须遵守整理
三、Android基本组件 1、【强制】Activity间的数据通信，对于数据量比较大的，避免使用Intent +...
Android组开发规范-参考95%参考阿里
Android组开发规范本文参考借鉴阿里Android规范一、目标 Android组开发规范用以指导团队成员，...
Android 开发规范
前言本文参考Google Java编程规范和阿里巴巴Java规范，Android编码规范部分参考Android开...
python编程规范
python编程规范在python 编码过程中遵循PEP8编程规范以下规范必须遵守一、代码编排缩进。4个空...
Android 代码命名规范
前言根据 Google Java 编程规范 & Google 官方 Android 编码规范，整理一份全面 & ...
如何统一代码风格？
项目有自己的不同代码规范风格，除了参照一些业内推荐的代码规范，比如，阿里巴巴Java开发手册，团队成员应该优先遵守...
开发规范
文章取自阿里技术公众号分享，本文章主要用于自己后续遵守规范，请勿随意传播命名规范我自己非常注重搭建项目结构的起...
阿里Java规范-02-异常日志
=================（一）异常处理==================关于接口使用抛异常还是返回错误...
规范问题
IOS官方规范 Material Design规范熟悉和整理必须开始收集整理素材了看追波上的同类案例进行功能上的整理
android知识点—阿里内部Android规范文档(转)
阿里内部Android规范文档一份合格的代码不应只满足于实现功能, 更应该遵循良好的规范. 遵循良好的代码规范有...

阿里Android规范-02-必须遵守整理

三、Android基本组件

四、UI与布局

五、进程、线程与消息通信

六、文件与数据库

七、Bitmap、Drawable与动画

八、安全

九、其他

相关文章

阿里Android规范-02-必须遵守整理

Android组开发规范-参考95%参考阿里

Android 开发规范

python编程规范

Android 代码命名规范

如何统一代码风格？

开发规范

阿里Java规范-02-异常日志

规范问题

android知识点—阿里内部Android规范文档(转)

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读