企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
[TOC] # 危险权限 ![](https://box.kancloud.cn/44a9ba33d010ab1c8921d9261e91b37d_901x890.jpg) # 存储 来源:[Android 存储使用参考](https://www.liaohuqiu.net/cn/posts/storage-in-android/) ```plain ($rootDir) +- /data -> Environment.getDataDirectory() | | | | ($appDataDir) | +- data/com.srain.cube.sample | | | | ($filesDir) | +- files -> Context.getFilesDir() / Context.getFileStreamPath("") | | | | | +- file1 -> Context.getFileStreamPath("file1") | | ($cacheDir) | +- cache -> Context.getCacheDir() | | | +- app_$name ->(Context.getDir(String name, int mode) | | ($rootDir) +- /storage/sdcard0 -> Environment.getExternalStorageDirectory() | / Environment.getExternalStoragePublicDirectory("") | +- dir1 -> Environment.getExternalStoragePublicDirectory("dir1") | | ($appDataDir) +- Andorid/data/com.srain.cube.sample | | ($filesDir) +- files -> Context.getExternalFilesDir("") | | | +- file1 -> Context.getExternalFilesDir("file1") | +- Music -> Context.getExternalFilesDir(Environment.Music); | +- Picture -> ... Environment.Picture | +- ... | | ($cacheDir) +- cache -> Context.getExternalCacheDir() | +- ??? ``` * 应用数据目录($appDataDir)包含:内部存储路径:`/data/data/$packageName` 和外部存储路径`/sdcard/Android/data/$packageName`,在 App被卸载后,会被系统删除,我们应该讲应用的数据存放于这两个目录中,需要用户额外保存的存放到外部存储其他目录中。 * 在$appDataDir下,一般包含数据缓存($cacheDir)和文件目录($filesDir)两个目录。 * 机身存储不足时,内部存储的$cacheDir目录下的文件会被删除,外部存储的$cacheDir目录不会 * 内部存储的$cacheDir和$filesDir文件是App安全的,其他应用无法读取;外部存储的这两个目录则不是,其他应用也可访问 * 外部存储的$filesDir中的媒体文件不会被当做媒体扫描出来加到媒体库中 # Proguard ## 关键字 关键字|描述 ---|--- keep|保留类名和类中的成员,防止它们被混淆或移除 keepnames|保留类名和类中的成员,只能防止它们被混淆(即不被改名),不能防止被移除。也就是假如成员没被引用就会被移除 keepclassmembers|只保留类中的成员,防止被混淆或移除 keepclassmembernames|只保留类中的成员,只能防止被混淆,不能防止被移除 keepclasseswithmembers|如果拥有某成员,才会保留类和类成员。并能防止它们被混淆和移除 keepclasseswithmembernames|如果拥有某成员,会保留类和类成员,只能防止被混淆,不能防止无引用的成员被移除 总结: * 带 names 的关键字,都只能防止被混淆,不能防止被移除。也就是假如成员没被引用,就会被移除 ## 通配符 通配符|描述 ---|--- &lt;field&gt;|匹配类中所有字段 &lt;method&gt;|匹配类中所有方法 &lt;init&gt;|匹配类中所有构造函数 \*|匹配任意长度字符,但不包括包名分隔符。不写任何内容,只写一个 \* 时,匹配所有东西 \**|匹配任意长度字符,包括包名分隔符 ***|匹配任意参数类型 ...|匹配任意长度的任意参数类型 参考文档: [Android安全攻防战,反编译与混淆技术完全解析(下)](http://blog.csdn.net/guolin_blog/article/details/50451259) [Android混淆从入门到精通](http://www.jianshu.com/p/7436a1a32891) # MIME 类型 ## 定义 MIME 类型即互联网媒体类型,是互联网上传输的内容的分类类型。 一份内容的互联网媒体类型由其文件格式和内容决定。互联网媒体类型与文件扩展名相对应,所以计算机通常根据文件扩展名来确定其媒体类型并确定关联软件。 MIME 类型至少包括两部分:类型(type)和子类型(subtype),还可包括一个或多个可选参数。格式如下: ```plain 类型名/子类型名 [; 可选参数] ``` 示例: ```plain text/html; charset = UTF-8 ``` ## 常用媒体类型列表 ### Type Application 媒体类型|说明 ---|--- application/ecmascript|ECMAScript/JavaScript(严格) application/javascript|ECMAScript/JavaScript(宽松) apllication/json|JSON application/octet-stream|任意二进制文件 apllication/pdf|PDF application/xml|XML 文件 application/zip|ZIP application/gzip|GZIP ...|... ### Type text 媒体类型|说明 ---|--- text/plain|纯文本文件 text/xml|XML 文件 text/css|CSS 文件 text/html|HTML 文件 ...|... ### Type image 媒体类型|说明 ---|--- image/gif|GIF 图像文件 image/jpeg|JPEG 图像文件 image/png|PNG 图像文件 image/webp|WebP 图像文件 ...|... ### Type audio 媒体类型|说明 ---|--- audio/mp4|MP4 音频文件 audio/mpeg|MP3 或其他 MPEG 音频文件 audio/vnd.wave|wave 音频文件 ...|... ### Type video 媒体类型|说明 ---|--- video/mp4|MP4 视频文件 video/ogg|Ogg 视频文件 video/quicktime|QuickTime 视频文件 ...|... 参考 [Wikipedia:互联网媒体类型](https://zh.wikipedia.org/wiki/%E4%BA%92%E8%81%94%E7%BD%91%E5%AA%92%E4%BD%93%E7%B1%BB%E5%9E%8B) # Parcelable 使用 ## 标准使用 ```java public class Student implements Parcelable { // 成员变量 private String mName; private int mAge; // Parcelable 接口方法 public int describeContents() { return 0; } // Parcelable 接口方法,用于向 Parcel 写入数据 public void writeToParcel(Parcel dest, int flags) { dest.writeString(mName); dest.writeInt(mAge); } // 用于从 Parcel 中读取数据,并创建对象 public static final Parcelable.Creator<Student> CREATOR = new Parcelable.Creator<Student>() { public Student createFromParcel(Parcel in) { return new Student(in); } public Student[] newArray(int size) { return new Student[size]; } }; private Student(Parcel in) { mName = in.readString(); mAge = in.readInt(); } } ``` 注意:writeToParcel 方法和 createFromParcel 方法中的顺序必须一致。 ## 注意事项 ### boolean 类型的序列化和反序列化 ```java // 序列化 dest.writeByte((byte) (isChecked ? 1 : 0)); // 反序列化 isChecked = in.readByte() != 0; ``` ### 类成员变量中存在非基本类型时 将该成员变量也实现 Parcelable 接口: ```java // 序列化 dest.writeParcelable(mBook, 0); // 反序列化,反序列化过程需要传递当前线程的上下文类加载器,否则会报无法找到该类的错误 mBook = in.readParcelable(Thread.currentThread().getContextClassLoader()); ``` ### 类的某个成员变量不可能实现 Parcelable 接口时 将该成员变量拆分为若干个必要的属性进行传递,反序列化后再进行组装: ```java // 序列化 dest.writeLong(calendar.getTimeInMillis()); dest.writeInt(calendar.getTimeZone().getID()); // 反序列化 mCalendar.setTimeInMillis(in.readLong()); mCalendar.getTimeZone().setID(in.readString()); ``` 参考 [Parcelable接口的使用](http://www.jianshu.com/p/97503d7faaf3) # Android 库模块注意事项 * **资源合并冲突** 构建工具会将库模块中的资源与相关应用模块的资源合并。如果在两个模块中均定义了给定资源 ID,将使用应用中的资源。 如果多个 AAR 库之间发生冲突,将使用依赖项列表首先列出(位于 dependencies 块顶部)的库中的资源。 为了避免常用资源 ID 的资源冲突,请使用在模块(或在所有项目模块)中具有唯一性的前缀或其他一致的命名方案。 * **库模块不得包含原始资源** 不支持在库模块中使用原始资源文件(保存在 assets/ 目录中)。应用使用的任何原始资源都必须存储在应用模块自身的 assets/ 目录中。 * **应用模块的 minSdkVersion 必须大于或等于库定义的版本** 库作为相关应用模块的一部分编译,因此,库模块中使用的 API 必须与应用模块支持的平台版本兼容。 参考 [创建 Android 库](https://developer.android.com/studio/projects/android-library.html?hl=zh-cn#CreateLibrary) # Android 手机方向问题 ## 方向坐标系定义 * X 轴的方向是沿着屏幕的水平方向从左向右,如果手机不是正方形的话,较短的边需要水平放置,较长的边需要垂直放置。 * Y 轴的方向是从屏幕的左下角开始沿着屏幕的的垂直方向指向屏幕的顶端。 * 手机放在桌子上,Z 轴的方向是从手机指向天空。 * 手机屏幕较长的一边定义为纵向,较短的一边定义为横向 * 手机围绕 X 轴旋转称为仰俯,围绕 Y 轴旋转称为反转,围绕 Z 轴旋转称为方向变化 ![](http://oj1xifth5.bkt.clouddn.com/wiki_android_sensor1.png) ## screenOrientation 清单文件中为 Activity 配置 screenOrientation 的常用值: 属性|含义 ---|--- unspecified|默认值,由系统选择方向,不同设备、系统可能会有差异 landscape|横向方向(显示界面的宽度大于高度) portrait|纵向方向(显示界面的高度大于宽度) reverseLandscape|与正常横向方向相反的横向方向 reversePortrait|与正常纵向方向相反的纵向方向 sensor|方向由设备方向传感器决定,取决于用户如何手持设备(一些设备默认不会旋转到上面所有 4 种可能的方向) sensorLandscape|横向方向,但根据设备传感器,可以是正常或反向的横向方向 sensorPortrait|纵向方向,但根据设备传感器,可以是正常或反向的纵向方向 fullSensor|方向由 4 种方向中任一方向的设备方向传感器决定 全部取值请见官方文档:[<activity>](https://developer.android.com/guide/topics/manifest/activity-element.html?hl=zh-cn) ## 相机方向问题 以下摘自 [Android 相机预览方向及其适配探索](https://dev.qq.com/topic/583ba1df25d735cd2797004d) 这篇文章,非常不错,值得一读。 相机图像数据来自于相机硬件的图像传感器(Image Sensor),这个 Sensor 被固定到手机之后是有一个默认的取景方向,且不会改变。 ![](http://oj1xifth5.bkt.clouddn.com/wiki_orientation_1.png) 对于一个横屏应用来说,屏幕“自然”方向和后置相机的图像传感器方向一致,因此看到的图像是正的,这个很好理解。 ![](http://oj1xifth5.bkt.clouddn.com/wiki_orientation_2.png) 而对于一个竖屏应用来说,屏幕“自然”方向和后置相机的图像传感器方向是不一致,从图像传感器的角度看,它看到的图像是侧过来的。 可以这样理解,将我们自己的眼睛比做相机取景器,手机在由水平方向旋转到竖直方向时,进行了顺时针旋转 90 度,而我们眼睛看图片的方向是没变的,所以头要跟着转 90 度。将此时看到的图像展示到手机上,就如下图所示了。 ![](http://oj1xifth5.bkt.clouddn.com/wiki_orientation_3.png) 需要将相机预览图像顺时针旋转 90 度,才和屏幕“自然”方向一致。在 Android 系统中,提供 camera.setDisplayOrientation(angle)方法,用来设置相机预览图像顺时针旋转的角度。 参考 [Android 利用方向传感器获得手机的相对角度](http://blog.csdn.net/dlutbrucezhang/article/details/9005281) [获取Android设备的方向](http://www.cnblogs.com/bpasser/archive/2011/10/17/2214517.html) [Android Orientation Sensor(方向传感器)详解与应用](http://blog.csdn.net/wlwlwlwl015/article/details/41759553) [Android 相机预览方向及其适配探索](https://dev.qq.com/topic/583ba1df25d735cd2797004d) # 系统签名 ```plain signapk.jar platform.x509.pem platform.pk8 app-release.apk new.apk ``` 参考 [Android 将自己的应用改为系统应用](http://blog.csdn.net/xx326664162/article/details/53406933) # Android虚拟机演进史 ![](https://img.kancloud.cn/57/d3/57d34ab9739b34be41d349446c58473f_969x165.jpg) * Android1.0 Dalvik(DVM)+解释器 DVM是Google开发的Android平台虚拟机,可读取.dex的字节码。Android1.0时期,程序一边运行,DVM中的解释器一边解释字节码为机器码,效率较低 * Android2.0 DVM+JIT Android2.0引入JIT(Just In Time)机制,在App打开的时候就开始编译,等到使用该功能时已经准备好了。 * Android4.4 Dalvik和ART共存 * Android5.0 ART+AOT Android5.0更改虚拟机为ART(Android Runtime),在应用安装时就把字节码编译为机器码,这个过程称为AOT(Ahead Of Time)。App安装时间会变长,并且占用空间也会变大,但用户使用时不再需要解释,使用时感觉速度变快。(但每次OTA启动,比如系统更新或刷机,都需要重新安装所有App) * Android7.0 混合编译 安装时并不预先编译,而是等手机空闲时使用AOT模式进行编译,使用时如果发现还未编译的代码就采用JIT和解释器来进行编译 * Android8.0 改进解释器 * Android9.0 改进编译模板 预先放置热点代码,应用在安装时就知道这是常用代码会提前编译 # NDK 原生开发套件(NDK,Native Development Kit),使用NDK我们可以在Android应用中使用C和C++代码,原生代码可以进一步提升设备性能,降低延迟,高效率运行计算密集型应用,如游戏或物理模拟等。 我们可以使用NDK将C和C++代码编译到so库中,再使用Gradle将so库打包到APK中,Java代码通过Java原生接口(JNI,Java Native Interface)来调用原生库中的代码。 Android Studio默认使用CMake编译原生代码,但也支持ndk-build工具,CMake支持跨平台,ndk-build仅支持 Android但速度更快。 LLDB是Android Studio中用于调试原生代码的工具。 ## 创建支持C/C++的新项目 在向导的Choose your project部分中,选择Native C++项目类型,即可创建一个支持原生代码的项目。创建后的项目会自动生成cpp组,其中包含原生源代码文件、头文件、CMake编译脚本或ndk-build编译脚本。 ![](https://img.kancloud.cn/05/f9/05f99e44bde773853471723ddc14def4_446x267.jpg) 我们运行项目时原生代码的编译及调用流程如下: 1、Gradle调用编译脚本CMakeLists.txt给CMake使用 2、CMake按照CMakeLists中的命令编译原生代码到对象库中,并命名为***.so文件 3、Gradle再将so库打包到APK中 4、应用运行时,先调用`System.loadLibrary()`方法加载原生库,然后就可以通过JNI调用原生库中的方法了 ## 为旧项目引入C/C++代码 1、在项目`src/main`目录下创建`cpp`目录 2、在cpp目录下创建编写C/C++源文件和头文件 3、配置CMake编译脚本 4、配置Gradle,让CMake项目作为编译依赖项,这样Gradle编译时才会把调用CMake编译原生代码 其实在创建新的支持C/C++项目时,Android Studio已经自动帮我们创建了上面的这些文件了。 ## CMake编译脚本配置 CMake编译脚本是一个纯文本文件,且必须命名为`CMakeLists.txt`。其中几个重要的命令如下: 1、cmake_minimium_required()命令用来设置CMake的最低版本需求 ```txt cmake_minimum_required(VERSION 3.4.1) ``` 2、add_library()命令用来设置源码文件路径和生成原生库的信息 ```txt add_library( # 设置原生库的名字 native-lib # 设置原生库是STATIC类型还是SHARED类型 SHARED # 设置原生源代码相对路径 native-lib.cpp) ``` 3、include_directories()命令用来设置原生代码头文件的路径 ```txt include_directories(src/main/cpp/include/) ``` 4、find_library()命令可以用来找到NDK库并将其路径存储为一个变量。Android手机平台已经内置了预编译的NDK库,我们只需将自己的原生库与其关联,就可以使用内置的NDK库了。 ```txt find_library( # 设置路径变量 log-lib # 指定需要CMake帮我们寻找的内置NDK库 log) ``` 5、target_link_libraries()命令用来关联我们自己的原生库和内置的预编译库。 ```txt target_link_libraries( # 指定我们自己的原生库 native-lib # 指定内置的预编译库 ${log-lib}) ``` 关联后,我们的原生库就可以调用内置的预编译库中的函数了。 6、除了Android内置的预编译过的NDK库,NDK还提供了一些源代码形式的库,我们自己的原生库需要使用时,也可以进行关联。 ```txt add_library( app-glue STATIC # 这里指定源代码的路径 ${ANDROID_NDK}/sources/android/native_app_glue/android_native_app_glue.c ) # 进行关联 target_link_libraries( native-lib app-glue ${log-lib} ) ``` 7、添加其他预编译库 8、包含其他CMake项目 ## 配置Gradle 配置好CMake编译脚本后,我们还需要向Gradle提供CMake脚本文件的路径,这样Gradle编译时才能找到。 1、配置模块的build.gradle文件 ```plain android { ... defaultConfig {...} buildTypes {...} externalNativeBuild { cmake { path "CMakeLists.txt" } } } ``` 2、指定可选配置 可以在模块的build.gradle文件的defaultConfig块中配置另一个externalNativeBuild块,为CMake或ndk-build指定可选参数和标记。 # EditText自动弹出软键盘 ## 方式一 1、在 EditText 的父布局中添加: ```xml android:focusable="true" android:focusableInTouchMode="true" ``` 2、在 java 代码中添加 ```java et_input.setFocusable(true); et_input.setFocusableInTouchMode(true); et_input.requestFocus(); activity.getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE); ``` ## 方式二 ![](https://img.kancloud.cn/3a/83/3a8385e933b8323367b86702737a998c_1112x330.png) 1、View参数最好是 EditText 或者它的子类。 考虑到软键盘就是为了输入,EditText 就是一个接收输入的控件。而这不是绝对的,如果不是一个 EditText ,就必须要求这个 View 有两个属性,分别是:android:focusable="true" 和android:focusableInTouchMode="true"。 2、View参数必须是可获取焦点的,并且当前已经获取到焦点。 EditText 默认是允许获取焦点的,但是假如布局中,存在多个可获取焦点的控件,就需要提前让我们传递进去的 View 获取到焦点。获取焦点可以使用 requestFocus() 方法。 3、布局必须加载完成。 在 onCreate() 中,如果立即调用 showSoftInput() 是不会生效的。想要在页面一启动的时候就弹出键盘,可以在 Activity 上,设置 android:windowSoftInputMode 属性来完成,或者做一个延迟加载,View.postDelayed() 也是一个解决方案。 ## 收起软键盘 ```java InputMethodManager manager = (InputMethodManager) mView.getContext().getSystemService(Context.INPUT_METHOD_SERVICE); if (manager != null) { manager.hideSoftInputFromWindow(mView.getWindowToken(), 0); } ``` # 禁止软键盘自动弹出 xml文件中,为EditText及其父布局添加如下属性即可: ```xml android:focusable="true" android:focusableInTouchMode="true" ``` # 复制文本 ```java String needCopyString = "need"; ClipboardManager manager = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE); if (manager != null !TextUtils.isEmpty(needCopyString)) { manager.setPrimaryClip(ClipData.newPlainText("copy_string", needCopyString)); Toast.makeText(mContext, "复制成功", Toast.LENGTH_SHORT).show(); } ``` # ScrollView使用注意事项 1、`ScrollView`的直接子View只能有一个,当内部有复杂布局时可以使用`LinearLayout`、`RelativeLayout`等进行包裹。 2、可以使用`layout_width`和`layout_height`给`ScrollView`指定大小。 3、`ScrollView`只用来处理需要滚动的不规则视图的组合。大批量的列表数据展示可以使用`ListView`、`GridView`或者`RecyclerView`。 4、`ScrollView`只支持竖直滑动,水平滑动使用`HorizontalScrollView`。 5、当`ScrollView`内部的视图不足以撑满屏幕时,使用`ScrollView`的`android:fillViewport`属性可以实现 # 软键盘的回车按钮变成搜索按钮 布局文件修改如下: ```xml <EditText //... android:imeOptions="actionSearch" android:singleLine="true" /> ``` 事件监听: ```java mEt.setOnEditorActionListener(new TextView.OnEditorActionListener() { @Override public boolean onEditorAction(TextView v, int actionId, KeyEvent event) { // 判断是否为搜索键 if(actionId == EditorInfo.IME_ACTION_SEARCH){ String key = mEt.getText().toString().trim(); if(TextUtils.isEmpty(key)){ ToastManager.showToastShort("请输入您想要搜索的地址"); return true; } // 业务逻辑 doSomething(key); // 隐藏键盘 hideKeyBoard(); return true; } return false; } }); ``` # SpannableString 使用技巧 ```java String s = "请您在使用鹿用招聘前仔细阅读并理解《用户协议》和《隐私政策》。"; int userProtocolStart = s.indexOf("《用户协议》"); int userProtocolEnd = userProtocolStart + "《用户协议》".length(); int secretStart = s.indexOf("《隐私政策》"); int secretEnd = secretStart + "《隐私政策》".length(); SpannableString spannableString = new SpannableString(s); spannableString.setSpan(new ForegroundColorSpan(0xff1890ff), userProtocolStart, userProtocolEnd, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE); spannableString.setSpan(new ForegroundColorSpan(0xff1890ff), secretStart, secretEnd, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE); spannableString.setSpan(new ClickableSpan() { @Override public void onClick(@NonNull View widget) { HyBirdWebViewActivity.startActivity(SplashActivity.this, NetUrl.URL_STRING_AGREEMENT_URL); } @Override public void updateDrawState(@NonNull TextPaint ds) { super.updateDrawState(ds); //设置文本的颜色 ds.setColor(ContextCompat.getColor(context, R.color.final_blue_main_35ABDC)); //超链接形式的下划线,false 表示不显示下划线,true表示显示下划线 ds.setUnderlineText(false); } }, userProtocolStart, userProtocolEnd, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE); spannableString.setSpan(new ClickableSpan() { @Override public void onClick(@NonNull View widget) { HyBirdWebViewActivity.startActivity(SplashActivity.this, NetUrl.URL_STRING_PRIACY_URL); } @Override public void updateDrawState(@NonNull TextPaint ds) { super.updateDrawState(ds); //设置文本的颜色 ds.setColor(ContextCompat.getColor(context, R.color.final_blue_main_35ABDC)); //超链接形式的下划线,false 表示不显示下划线,true表示显示下划线 ds.setUnderlineText(false); } }, secretStart, secretEnd, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE); mTvProtocol.setMovementMethod(LinkMovementMethod.getInstance()); mTvProtocol.setText(spannableString); ``` # 颜色透明度转换 100% — FF 95% — F2 90% — E6 85% — D9 80% — CC 75% — BF 70% — B3 65% — A6 60% — 99 55% — 8C 50% — 80 45% — 73 40% — 66 35% — 59 30% — 4D 25% — 40 20% — 33 15% — 26 10% — 1A 5% — 0D 0% — 00