Xposed框架中XSharePreference的使用
在Xposed框架的模块编写中，通常希望我们自己写的Android界面控制部分能够对Xposde框架的模块进行配置，也就说在当前Android应用中写的SharePreference文件，在其他Android应用加载该Xposde模块时，在执行的Xposed模块代码中能够访问到前面提到的SharePreference配置文件。当然了将配置文件写在Android应用的sd卡路径下是可以的，但是到了Android系统7.0的高版本时，基于sd卡文件的访问权限问题，使得这种方法不是很好使，当然了基于SharePreference配置文件的数据共享方法也不好使。这里只是学习一下Xposed框架中XSharePreference的使用方法，具体遇到的问题就是《一个基于xposed和inline hook的一代壳脱壳工具》中，关于Xposed模块共享配置文件问题的讨论，总之呢，到了Android 7.0版本的系统，基于权限和安全性的考虑，这两种方法都不是最佳的共享数据的通用方法。
一、普通情况下，Android应用跨进程共享文件数据的方法，可以参考博客《读、写其他应用程序的SharedPreferences》的讲解。
要读、写其他Android应用的SharedPreferences文件，需要共享该SharedPreferences文件的Android应用程序指定相应的访问权限，例如：MODE_WORLD_READABLE表明该SharedPreferences可被其他应用程序读取；指定MODE_WORLD_WRITEABLE，表明该SharedPreferences可被其他程序写入。
操作步骤：
1、创建其他Android应用程序对应的Context。
2、调用上面Context的getSharedPreferences(String name,int mode)，获取相应的SharedPreferences对象。
3、如果需要写入数据，调用SharedPreferences的edit()方法获取相应的Editor即可。
摘抄一下作者冯健-developer大大的博客代码，进行演示说明：
共享SharedPreferences配置文件数据的Android应用：
image
获取共享的SharedPreferences配置文件数据的Android应用：
image
但是这个Android跨进程共享SharedPreferences文件数据的方案，在Android的高版本系统上并不好使，具体的可以参考博客《SharedPreferences多进程解决方案》的描述，google官方还是推荐使用ContentProvider的方法进行替代，具体的内容如下：
image
二、Xposed框架下，Android应用与编写的Xposed模块进行SharedPreferences文件数据共享的实现。
对于Android应用与编写的Xposed模块进行SharedPreferences文件数据的共享，Xposed框架提供了XSharePreference的解决方法，不过需要说明的Xposed框架提供的XSharePreference只能实现SharedPreferences文件数据共享的读，不支持跨进程SharedPreferences文件数据共享的写。SharePrefernce实际上是对应路径/data/data/<Package Name>/shared_prefs/<Package Name>_preferences.xml的文件，里面按键值对的形式存放。XSharedPreferences做的工作实际上就是根据<Package Name>自己去获取和解析这个配置文件，然后读出该配置文件中的数据存放在一个HashMap当中，这些可以从XSharedPreferences的源码中了解到。
package de.robv.android.xposed;
import android.annotation.SuppressLint;
import android.content.Context;
import android.content.SharedPreferences;
import android.os.Environment;
import android.preference.PreferenceManager;
import android.util.Log;
import com.android.internal.util.XmlUtils;
import org.xmlpull.v1.XmlPullParserException;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import java.util.Set;
import de.robv.android.xposed.services.FileResult;
/**
* This class is basically the same as SharedPreferencesImpl from AOSP, but
* read-only and without listeners support. Instead, it is made to be
* compatible with all ROMs.
*/
public final class XSharedPreferences implements SharedPreferences {
private static final String TAG = "XSharedPreferences";
private final File mFile;
private final String mFilename;
private Map<String, Object> mMap;
private boolean mLoaded = false;
private long mLastModified;
private long mFileSize;
/**
* Read settings from the specified file.
* @param prefFile The file to read the preferences from.
*/
public XSharedPreferences(File prefFile) {
mFile = prefFile;
mFilename = mFile.getAbsolutePath();
startLoadFromDisk();
}
/**
* Read settings from the default preferences for a package.
* These preferences are returned by {@link PreferenceManager#getDefaultSharedPreferences}.
* @param packageName The package name.
*/
public XSharedPreferences(String packageName) {
// 调用XSharedPreferences(String packageName, String prefFileName)函数
this(packageName, packageName + "_preferences");
}
/**
* Read settings from a custom preferences file for a package.
* These preferences are returned by {@link Context#getSharedPreferences(String, int)}.
* @param packageName The package name.
* @param prefFileName The file name without ".xml".
*/
public XSharedPreferences(String packageName, String prefFileName) {
// Environment.getDataDirectory()获取Android系统的/data目录
// 在/data/data/路径下创建共享xml文件
mFile = new File(Environment.getDataDirectory(), "data/" + packageName + "/shared_prefs/" + prefFileName + ".xml");
// 获取文件全路径
mFilename = mFile.getAbsolutePath();
startLoadFromDisk();
}
/**
* Tries to make the preferences file world-readable.
*
* <p><strong>Warning:</strong> This is only meant to work around permission "fix" functions that are part
* of some recoveries. It doesn't replace the need to open preferences with {@code MODE_WORLD_READABLE}
* in the module's UI code. Otherwise, Android will set stricter permissions again during the next save.
*
* <p>This will only work if executed as root (e.g. {@code initZygote()}) and only if SELinux is disabled.
*
* @return {@code true} in case the file could be made world-readable.
*/
@SuppressLint("SetWorldReadable")
public boolean makeWorldReadable() {
if (!SELinuxHelper.getAppDataFileService().hasDirectFileAccess())
return false; // It doesn't make much sense to make the file readable if we wouldn't be able to access it anyway.
if (!mFile.exists()) // Just in case - the file should never be created if it doesn't exist.
return false;
// 设置文件为全局可读
return mFile.setReadable(true, false);
}
/**
* Returns the file that is backing these preferences.
*
* <p><strong>Warning:</strong> The file might not be accessible directly.
*/
public File getFile() {
return mFile;
}
private void startLoadFromDisk() {
synchronized (this) {
mLoaded = false;
}
new Thread("XSharedPreferences-load") {
@Override
public void run() {
synchronized (XSharedPreferences.this) {
loadFromDiskLocked();
}
}
}.start();
}
@SuppressWarnings({ "rawtypes", "unchecked" })
private void loadFromDiskLocked() {
if (mLoaded) {
return;
}
Map map = null;
FileResult result = null;
try {
result = SELinuxHelper.getAppDataFileService().getFileInputStream(mFilename, mFileSize, mLastModified);
if (result.stream != null) {
map = XmlUtils.readMapXml(result.stream);
result.stream.close();
} else {
// The file is unchanged, keep the current values
map = mMap;
}
} catch (XmlPullParserException e) {
Log.w(TAG, "getSharedPreferences", e);
} catch (FileNotFoundException ignored) {
// SharedPreferencesImpl has a canRead() check, so it doesn't log anything in case the file doesn't exist
} catch (IOException e) {
Log.w(TAG, "getSharedPreferences", e);
} finally {
if (result != null && result.stream != null) {
try {
result.stream.close();
} catch (RuntimeException rethrown) {
throw rethrown;
} catch (Exception ignored) {
}
}
}
mLoaded = true;
if (map != null) {
mMap = map;
mLastModified = result.mtime;
mFileSize = result.size;
} else {
mMap = new HashMap<>();
}
notifyAll();
}
/**
* Reload the settings from file if they have changed.
*
* <p><strong>Warning:</strong> With enforcing SELinux, this call might be quite expensive.
*/
public synchronized void reload() {
if (hasFileChanged())
startLoadFromDisk();
}
/**
* Check whether the file has changed since the last time it has been loaded.
*
* <p><strong>Warning:</strong> With enforcing SELinux, this call might be quite expensive.
*/
public synchronized boolean hasFileChanged() {
try {
FileResult result = SELinuxHelper.getAppDataFileService().statFile(mFilename);
return mLastModified != result.mtime || mFileSize != result.size;
} catch (FileNotFoundException ignored) {
// SharedPreferencesImpl doesn't log anything in case the file doesn't exist
return true;
} catch (IOException e) {
Log.w(TAG, "hasFileChanged", e);
return true;
}
}
private void awaitLoadedLocked() {
while (!mLoaded) {
try {
wait();
} catch (InterruptedException unused) {
}
}
}
/** @hide */
@Override
public Map<String, ?> getAll() {
synchronized (this) {
awaitLoadedLocked();
return new HashMap<>(mMap);
}
}
/** @hide */
@Override
public String getString(String key, String defValue) {
synchronized (this) {
awaitLoadedLocked();
String v = (String)mMap.get(key);
return v != null ? v : defValue;
}
}
/** @hide */
@Override
@SuppressWarnings("unchecked")
public Set<String> getStringSet(String key, Set<String> defValues) {
synchronized (this) {
awaitLoadedLocked();
Set<String> v = (Set<String>) mMap.get(key);
return v != null ? v : defValues;
}
}
/** @hide */
@Override
public int getInt(String key, int defValue) {
synchronized (this) {
awaitLoadedLocked();
Integer v = (Integer)mMap.get(key);
return v != null ? v : defValue;
}
}
/** @hide */
@Override
public long getLong(String key, long defValue) {
synchronized (this) {
awaitLoadedLocked();
Long v = (Long)mMap.get(key);
return v != null ? v : defValue;
}
}
/** @hide */
@Override
public float getFloat(String key, float defValue) {
synchronized (this) {
awaitLoadedLocked();
Float v = (Float)mMap.get(key);
return v != null ? v : defValue;
}
}
/** @hide */
@Override
public boolean getBoolean(String key, boolean defValue) {
synchronized (this) {
awaitLoadedLocked();
Boolean v = (Boolean)mMap.get(key);
return v != null ? v : defValue;
}
}
/** @hide */
@Override
public boolean contains(String key) {
synchronized (this) {
awaitLoadedLocked();
return mMap.containsKey(key);
}
}
/** @deprecated Not supported by this implementation. */
@Deprecated
@Override
public Editor edit() {
// 不支持共享配置文件的写操作
throw new UnsupportedOperationException("read-only implementation");
}
/** @deprecated Not supported by this implementation. */
@Deprecated
@Override
public void registerOnSharedPreferenceChangeListener(OnSharedPreferenceChangeListener listener) {
throw new UnsupportedOperationException("listeners are not supported in this implementation");
}
/** @deprecated Not supported by this implementation. */
@Deprecated
@Override
public void unregisterOnSharedPreferenceChangeListener(OnSharedPreferenceChangeListener listener) {
throw new UnsupportedOperationException("listeners are not supported in this implementation");
}
}
XSharedPreferences的api使用说明：https://api.xposed.info/reference/de/robv/android/xposed/XSharedPreferences.html
1.使用 XSharedPreferences(String packageName) 获取共享配置文件SharedPreferences的数据。
构造函数的源码如下，在构建XSharedPreferences对象设置默认的xml文件的文件名称为packageName+"_preferences"，很显然构造函数XSharedPreferences(String packageName)最终是调用的构造函数XSharedPreferences(String packageName, String prefFileName)来实现的，只是传给该构造函数的第2个参数是默认的packageName+"_preferences"。
image
XSharedPreferences(String packageName)函数的使用说明：
image
保存数据到共享配置文件SharedPreferences中，使用的场景是自己写的Xposed框架一般都会做个界面，继承Activity的，保存数据是直接正常保存，唯一注意的就是初始化SharedPreferences的时候，权限要写成：Activity.MODE_WORLD_READABLE。这样的话，在其他的Xposed模块才能访问到这个共享的配置文件SharedPreferences，但是在Android 7.0的系统上还是会存在问题，不好使。
// 创建共享配置文件的时，设置为Activity.MODE_WORLD_READABLE模式
SharedPreferences sp = getActivity()
.getSharedPreferences(getPackageName() + "_preferences", Activity.MODE_WORLD_READABLE);
SharedPreferences.Editor editor = sp.edit();
// 保存数据到共享配置文件中
editor.putString("test_put", "test_put").commit();
在编写的Xposed模块中，对共享的SharedPreferences文件数据进行访问：
// 其中"com.xxx.yyy"为共享SharedPreferences文件数据的Android应用的包名
XSharedPreferences intance = new XSharedPreferences("xxx.yyy.zzz");
String strHello = intance.getString("test_put", "");
2.使用XSharedPreferences(String packageName, String prefFileName)获取共享配置文件SharedPreferences的数据。
构造函数的源码如下：
image
构造函数的使用说明：
image
数据的保存：
SharedPreferences sp = getActivity().getSharedPreferences("config", Activity.MODE_WORLD_READABLE);
SharedPreferences.Editor editor = sp.edit();editor.putBoolean("isOk", true).commit();
数据的访问：
在XSharePreference初始化完成后，一定要设置为可读取即makeWorldReadable()。XSharedPreferences是只读的，并不允许进行写操作，从源码中实现中就可以看出来，代码来自于博客《Xposed中的XSharePreference的使用》。
public class PreferenceUtils {
public static final String AUTO_ALL ="auto_all";
public static final String REPLY_CONTENT ="reply_content";
public static final String REPLY_ORDER ="reply_order";
public static final String REPLY_ROBOT ="reply_robot";
public static final String REPLY_DESCRIBE ="reply_describe";
private static XSharedPreferences intance = null;
public static XSharedPreferences getIntance(){
if (intance == null){
intance = new XSharedPreferences("com.ydscience.fakemomo","config");
intance.makeWorldReadable();
}else {
intance.reload();
}
return intance;
}
public static boolean openAll(){
return getIntance().getBoolean(AUTO_ALL,false);
}
public static String replyContent(){
return getIntance().getString(REPLY_CONTENT,"请设置自动回复内容");
}
}
提供一个Xposed框架中XSharePreference使用的例子，来源于看雪论坛《一个基于xposed和inline hook的一代壳脱壳工具》下面关于该脱壳插件改进讨论的例子代码，在这个基础上根据需求进行修改即可：
/**
* Created by virjar on 2018/2/24.<br>
* 原方案，在宿主apk无sd卡权限时，无法hook无法读取配置，所以使用XSharePreference来处理多apk配置通信问题，这是因为shardPreference可以开放读取权限，绕开了不同app私有文件通信问题
*/
class XSharePreferenceConfig {
private static final String pluginPackage = "com.smartdone.dexdump";
private static final String configName = "dumpapps";
//可写的XSharedPreferences对象，这个可以使用在插件自己的apk里面使用
private SharedPreferences writeXSharedPreferences = null;
//只读的XSharedPreferences,这个可以让插件在宿主Android应用里面访问
private SharedPreferences readXSharedPreferences = null;
@SuppressLint("WorldReadableFiles")
void initWriteSharedPreference(Context pluginHostContext) {
if (!StringUtils.equals(pluginHostContext.getApplicationInfo().packageName, pluginPackage)) {
throw new IllegalStateException("can not create write sharedPreference in host app");
}
if (writeXSharedPreferences != null) {
return;
}
writeXSharedPreferences = pluginHostContext.getSharedPreferences(configName, Context.MODE_WORLD_READABLE);
}
void initReadSharePreference() {
if (readXSharedPreferences != null) {
return;
}
readXSharedPreferences = new XSharedPreferences(pluginPackage, configName);
}
private SharedPreferences getBindSharePreference() {
if (writeXSharedPreferences != null) {
return writeXSharedPreferences;
}
if (readXSharedPreferences != null) {
return readXSharedPreferences;
}
throw new IllegalStateException("not inited");
}
// 向共享配置文件中添加数据
void addOne(String name) {
SharedPreferences bindSharePreference = getBindSharePreference();
Set<String> stringSet = Sets.newHashSet(Splitter.on(",").splitToList(bindSharePreference.getString(configName, "")));
stringSet.add(name);
bindSharePreference.edit().putString(configName, Joiner.on(",").join(stringSet)).apply();
}
// 从共享配置文件中移除数据
void removeOne(String name) {
SharedPreferences bindSharePreference = getBindSharePreference();
Set<String> stringSet = Sets.newHashSet(Splitter.on(",").splitToList(bindSharePreference.getString(configName, "")));
stringSet.remove(name);
bindSharePreference.edit().putString(configName, Joiner.on(",").join(stringSet)).apply();
}
// 获取共享的配置文件中的数据
Set<String> getConfig() {
return Sets.newHashSet(Splitter.on(",").splitToList(getBindSharePreference().getString(configName, "")));
}
static boolean contains(Set<String> lists, String name) {
if (lists == null) {
return false;
}
for (String l : lists) {
if (l.equals(name)) {
return true;
}
}
return false;
}
}
比较不错的博客参考链接，很多知识点都是结合Xposed的api参考文档和源码以及这些博客搬运过来：
Xposed的api参考文档: https://api.xposed.info/reference/packages.html
《Xposed Xposed读取SharedPreferences》
如果你有想学习的文章直接留言，我会整理征稿。如果你有好的文章想和大家分享欢迎投稿，直接向我投递文章链接即可。
欢迎长按下图->识别图中二维码或者扫一扫关注我的公众号：
image
