1b104340496e3a531e26c8f428c808eca0e039f50San Mehat/* 2b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Copyright (C) 2008 The Android Open Source Project 3b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 4b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Licensed under the Apache License, Version 2.0 (the "License"); 5b104340496e3a531e26c8f428c808eca0e039f50San Mehat * you may not use this file except in compliance with the License. 6b104340496e3a531e26c8f428c808eca0e039f50San Mehat * You may obtain a copy of the License at 7b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 8b104340496e3a531e26c8f428c808eca0e039f50San Mehat * http://www.apache.org/licenses/LICENSE-2.0 9b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 10b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Unless required by applicable law or agreed to in writing, software 11b104340496e3a531e26c8f428c808eca0e039f50San Mehat * distributed under the License is distributed on an "AS IS" BASIS, 12b104340496e3a531e26c8f428c808eca0e039f50San Mehat * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13b104340496e3a531e26c8f428c808eca0e039f50San Mehat * See the License for the specific language governing permissions and 14b104340496e3a531e26c8f428c808eca0e039f50San Mehat * limitations under the License. 15b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 16b104340496e3a531e26c8f428c808eca0e039f50San Mehat 17b104340496e3a531e26c8f428c808eca0e039f50San Mehatpackage android.os.storage; 18b104340496e3a531e26c8f428c808eca0e039f50San Mehat 19b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkeyimport android.app.NotificationManager; 20b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkeyimport android.content.Context; 21cba928cef7d614d375253246f014c4a52bb8b913Mike Lockwoodimport android.os.Environment; 22b104340496e3a531e26c8f428c808eca0e039f50San Mehatimport android.os.Handler; 23a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Rootimport android.os.Looper; 24b104340496e3a531e26c8f428c808eca0e039f50San Mehatimport android.os.Message; 252f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwoodimport android.os.Parcelable; 26a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Rootimport android.os.RemoteException; 27b104340496e3a531e26c8f428c808eca0e039f50San Mehatimport android.os.ServiceManager; 28b104340496e3a531e26c8f428c808eca0e039f50San Mehatimport android.util.Log; 29af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Rootimport android.util.SparseArray; 30b104340496e3a531e26c8f428c808eca0e039f50San Mehat 314fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkeyimport com.android.internal.util.Preconditions; 324fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey 334fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkeyimport java.io.File; 344fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkeyimport java.io.IOException; 3505105f7abe02b2dff91d6260b3628c8b97816babKenny Rootimport java.lang.ref.WeakReference; 36b104340496e3a531e26c8f428c808eca0e039f50San Mehatimport java.util.ArrayList; 3705105f7abe02b2dff91d6260b3628c8b97816babKenny Rootimport java.util.List; 38af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Rootimport java.util.concurrent.atomic.AtomicInteger; 39b104340496e3a531e26c8f428c808eca0e039f50San Mehat 40b104340496e3a531e26c8f428c808eca0e039f50San Mehat/** 4105105f7abe02b2dff91d6260b3628c8b97816babKenny Root * StorageManager is the interface to the systems storage service. The storage 4205105f7abe02b2dff91d6260b3628c8b97816babKenny Root * manager handles storage-related items such as Opaque Binary Blobs (OBBs). 4305105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <p> 4405105f7abe02b2dff91d6260b3628c8b97816babKenny Root * OBBs contain a filesystem that maybe be encrypted on disk and mounted 4505105f7abe02b2dff91d6260b3628c8b97816babKenny Root * on-demand from an application. OBBs are a good way of providing large amounts 4605105f7abe02b2dff91d6260b3628c8b97816babKenny Root * of binary assets without packaging them into APKs as they may be multiple 4705105f7abe02b2dff91d6260b3628c8b97816babKenny Root * gigabytes in size. However, due to their size, they're most likely stored in 4805105f7abe02b2dff91d6260b3628c8b97816babKenny Root * a shared storage pool accessible from all programs. The system does not 4905105f7abe02b2dff91d6260b3628c8b97816babKenny Root * guarantee the security of the OBB file itself: if any program modifies the 5005105f7abe02b2dff91d6260b3628c8b97816babKenny Root * OBB, there is no guarantee that a read from that OBB will produce the 5105105f7abe02b2dff91d6260b3628c8b97816babKenny Root * expected output. 5205105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <p> 53b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Get an instance of this class by calling 5405105f7abe02b2dff91d6260b3628c8b97816babKenny Root * {@link android.content.Context#getSystemService(java.lang.String)} with an 5505105f7abe02b2dff91d6260b3628c8b97816babKenny Root * argument of {@link android.content.Context#STORAGE_SERVICE}. 56b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 57b104340496e3a531e26c8f428c808eca0e039f50San Mehat 58b104340496e3a531e26c8f428c808eca0e039f50San Mehatpublic class StorageManager 59b104340496e3a531e26c8f428c808eca0e039f50San Mehat{ 60b104340496e3a531e26c8f428c808eca0e039f50San Mehat private static final String TAG = "StorageManager"; 61b104340496e3a531e26c8f428c808eca0e039f50San Mehat 62b104340496e3a531e26c8f428c808eca0e039f50San Mehat /* 63b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Our internal MountService binder reference 64b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 656614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong final private IMountService mMountService; 66b104340496e3a531e26c8f428c808eca0e039f50San Mehat 67b104340496e3a531e26c8f428c808eca0e039f50San Mehat /* 68b104340496e3a531e26c8f428c808eca0e039f50San Mehat * The looper target for callbacks 69b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 70b104340496e3a531e26c8f428c808eca0e039f50San Mehat Looper mTgtLooper; 71b104340496e3a531e26c8f428c808eca0e039f50San Mehat 72b104340496e3a531e26c8f428c808eca0e039f50San Mehat /* 73b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Target listener for binder callbacks 74b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 75b104340496e3a531e26c8f428c808eca0e039f50San Mehat private MountServiceBinderListener mBinderListener; 76b104340496e3a531e26c8f428c808eca0e039f50San Mehat 77b104340496e3a531e26c8f428c808eca0e039f50San Mehat /* 78b104340496e3a531e26c8f428c808eca0e039f50San Mehat * List of our listeners 79b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 80af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root private List<ListenerDelegate> mListeners = new ArrayList<ListenerDelegate>(); 81af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 82af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root /* 83af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * Next available nonce 84af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root */ 85af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final private AtomicInteger mNextNonce = new AtomicInteger(0); 86b104340496e3a531e26c8f428c808eca0e039f50San Mehat 87b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class MountServiceBinderListener extends IMountServiceListener.Stub { 88b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void onUsbMassStorageConnectionChanged(boolean available) { 89b104340496e3a531e26c8f428c808eca0e039f50San Mehat final int size = mListeners.size(); 90b104340496e3a531e26c8f428c808eca0e039f50San Mehat for (int i = 0; i < size; i++) { 91b104340496e3a531e26c8f428c808eca0e039f50San Mehat mListeners.get(i).sendShareAvailabilityChanged(available); 92b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 93b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 94b104340496e3a531e26c8f428c808eca0e039f50San Mehat 95b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void onStorageStateChanged(String path, String oldState, String newState) { 96b104340496e3a531e26c8f428c808eca0e039f50San Mehat final int size = mListeners.size(); 97b104340496e3a531e26c8f428c808eca0e039f50San Mehat for (int i = 0; i < size; i++) { 98b104340496e3a531e26c8f428c808eca0e039f50San Mehat mListeners.get(i).sendStorageStateChanged(path, oldState, newState); 99b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 100b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 101b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 102b104340496e3a531e26c8f428c808eca0e039f50San Mehat 103b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 104a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * Binder listener for OBB action results. 105a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root */ 10605105f7abe02b2dff91d6260b3628c8b97816babKenny Root private final ObbActionListener mObbActionListener = new ObbActionListener(); 10705105f7abe02b2dff91d6260b3628c8b97816babKenny Root 10805105f7abe02b2dff91d6260b3628c8b97816babKenny Root private class ObbActionListener extends IObbActionListener.Stub { 10937051cdd8624c4821bb68169be427061c48ad837Gilles Debunne @SuppressWarnings("hiding") 110af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root private SparseArray<ObbListenerDelegate> mListeners = new SparseArray<ObbListenerDelegate>(); 11105105f7abe02b2dff91d6260b3628c8b97816babKenny Root 112a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root @Override 11337051cdd8624c4821bb68169be427061c48ad837Gilles Debunne public void onObbResult(String filename, int nonce, int status) { 114af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final ObbListenerDelegate delegate; 11505105f7abe02b2dff91d6260b3628c8b97816babKenny Root synchronized (mListeners) { 116af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root delegate = mListeners.get(nonce); 117af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (delegate != null) { 118af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root mListeners.remove(nonce); 11905105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 12005105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 12105105f7abe02b2dff91d6260b3628c8b97816babKenny Root 122af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (delegate != null) { 123af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root delegate.sendObbStateChanged(filename, status); 12405105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 125af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 12605105f7abe02b2dff91d6260b3628c8b97816babKenny Root 127af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root public int addListener(OnObbStateChangeListener listener) { 128af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final ObbListenerDelegate delegate = new ObbListenerDelegate(listener); 12905105f7abe02b2dff91d6260b3628c8b97816babKenny Root 130af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root synchronized (mListeners) { 131af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root mListeners.put(delegate.nonce, delegate); 13205105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 133af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 134af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root return delegate.nonce; 13505105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 13605105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 13705105f7abe02b2dff91d6260b3628c8b97816babKenny Root 138af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root private int getNextNonce() { 139af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root return mNextNonce.getAndIncrement(); 140af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 141af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 14205105f7abe02b2dff91d6260b3628c8b97816babKenny Root /** 14305105f7abe02b2dff91d6260b3628c8b97816babKenny Root * Private class containing sender and receiver code for StorageEvents. 14405105f7abe02b2dff91d6260b3628c8b97816babKenny Root */ 14505105f7abe02b2dff91d6260b3628c8b97816babKenny Root private class ObbListenerDelegate { 14605105f7abe02b2dff91d6260b3628c8b97816babKenny Root private final WeakReference<OnObbStateChangeListener> mObbEventListenerRef; 14705105f7abe02b2dff91d6260b3628c8b97816babKenny Root private final Handler mHandler; 14805105f7abe02b2dff91d6260b3628c8b97816babKenny Root 149af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root private final int nonce; 150af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 15105105f7abe02b2dff91d6260b3628c8b97816babKenny Root ObbListenerDelegate(OnObbStateChangeListener listener) { 152af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root nonce = getNextNonce(); 15305105f7abe02b2dff91d6260b3628c8b97816babKenny Root mObbEventListenerRef = new WeakReference<OnObbStateChangeListener>(listener); 15405105f7abe02b2dff91d6260b3628c8b97816babKenny Root mHandler = new Handler(mTgtLooper) { 15505105f7abe02b2dff91d6260b3628c8b97816babKenny Root @Override 15605105f7abe02b2dff91d6260b3628c8b97816babKenny Root public void handleMessage(Message msg) { 15737051cdd8624c4821bb68169be427061c48ad837Gilles Debunne final OnObbStateChangeListener changeListener = getListener(); 15837051cdd8624c4821bb68169be427061c48ad837Gilles Debunne if (changeListener == null) { 15905105f7abe02b2dff91d6260b3628c8b97816babKenny Root return; 16005105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 16105105f7abe02b2dff91d6260b3628c8b97816babKenny Root 16205105f7abe02b2dff91d6260b3628c8b97816babKenny Root StorageEvent e = (StorageEvent) msg.obj; 16305105f7abe02b2dff91d6260b3628c8b97816babKenny Root 16405105f7abe02b2dff91d6260b3628c8b97816babKenny Root if (msg.what == StorageEvent.EVENT_OBB_STATE_CHANGED) { 16505105f7abe02b2dff91d6260b3628c8b97816babKenny Root ObbStateChangedStorageEvent ev = (ObbStateChangedStorageEvent) e; 16637051cdd8624c4821bb68169be427061c48ad837Gilles Debunne changeListener.onObbStateChange(ev.path, ev.state); 16705105f7abe02b2dff91d6260b3628c8b97816babKenny Root } else { 16805105f7abe02b2dff91d6260b3628c8b97816babKenny Root Log.e(TAG, "Unsupported event " + msg.what); 16905105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 17005105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 17105105f7abe02b2dff91d6260b3628c8b97816babKenny Root }; 17205105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 17305105f7abe02b2dff91d6260b3628c8b97816babKenny Root 17405105f7abe02b2dff91d6260b3628c8b97816babKenny Root OnObbStateChangeListener getListener() { 17505105f7abe02b2dff91d6260b3628c8b97816babKenny Root if (mObbEventListenerRef == null) { 17605105f7abe02b2dff91d6260b3628c8b97816babKenny Root return null; 17705105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 17805105f7abe02b2dff91d6260b3628c8b97816babKenny Root return mObbEventListenerRef.get(); 17905105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 18005105f7abe02b2dff91d6260b3628c8b97816babKenny Root 181af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root void sendObbStateChanged(String path, int state) { 18205105f7abe02b2dff91d6260b3628c8b97816babKenny Root ObbStateChangedStorageEvent e = new ObbStateChangedStorageEvent(path, state); 18305105f7abe02b2dff91d6260b3628c8b97816babKenny Root mHandler.sendMessage(e.getMessage()); 18405105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 18505105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 18605105f7abe02b2dff91d6260b3628c8b97816babKenny Root 18705105f7abe02b2dff91d6260b3628c8b97816babKenny Root /** 18805105f7abe02b2dff91d6260b3628c8b97816babKenny Root * Message sent during an OBB status change event. 18905105f7abe02b2dff91d6260b3628c8b97816babKenny Root */ 19005105f7abe02b2dff91d6260b3628c8b97816babKenny Root private class ObbStateChangedStorageEvent extends StorageEvent { 19105105f7abe02b2dff91d6260b3628c8b97816babKenny Root public final String path; 19205105f7abe02b2dff91d6260b3628c8b97816babKenny Root 193af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root public final int state; 194af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 195af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root public ObbStateChangedStorageEvent(String path, int state) { 19605105f7abe02b2dff91d6260b3628c8b97816babKenny Root super(EVENT_OBB_STATE_CHANGED); 19705105f7abe02b2dff91d6260b3628c8b97816babKenny Root this.path = path; 19805105f7abe02b2dff91d6260b3628c8b97816babKenny Root this.state = state; 199a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root } 200a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root } 201a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root 202a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root /** 203b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Private base class for messages sent between the callback thread 204b104340496e3a531e26c8f428c808eca0e039f50San Mehat * and the target looper handler. 205b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 206b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class StorageEvent { 20705105f7abe02b2dff91d6260b3628c8b97816babKenny Root static final int EVENT_UMS_CONNECTION_CHANGED = 1; 20805105f7abe02b2dff91d6260b3628c8b97816babKenny Root static final int EVENT_STORAGE_STATE_CHANGED = 2; 20905105f7abe02b2dff91d6260b3628c8b97816babKenny Root static final int EVENT_OBB_STATE_CHANGED = 3; 210b104340496e3a531e26c8f428c808eca0e039f50San Mehat 211b104340496e3a531e26c8f428c808eca0e039f50San Mehat private Message mMessage; 212b104340496e3a531e26c8f428c808eca0e039f50San Mehat 213b104340496e3a531e26c8f428c808eca0e039f50San Mehat public StorageEvent(int what) { 214b104340496e3a531e26c8f428c808eca0e039f50San Mehat mMessage = Message.obtain(); 215b104340496e3a531e26c8f428c808eca0e039f50San Mehat mMessage.what = what; 216b104340496e3a531e26c8f428c808eca0e039f50San Mehat mMessage.obj = this; 217b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 218b104340496e3a531e26c8f428c808eca0e039f50San Mehat 219b104340496e3a531e26c8f428c808eca0e039f50San Mehat public Message getMessage() { 220b104340496e3a531e26c8f428c808eca0e039f50San Mehat return mMessage; 221b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 222b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 223b104340496e3a531e26c8f428c808eca0e039f50San Mehat 224b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 225b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Message sent on a USB mass storage connection change. 226b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 227b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class UmsConnectionChangedStorageEvent extends StorageEvent { 228b104340496e3a531e26c8f428c808eca0e039f50San Mehat public boolean available; 229b104340496e3a531e26c8f428c808eca0e039f50San Mehat 230b104340496e3a531e26c8f428c808eca0e039f50San Mehat public UmsConnectionChangedStorageEvent(boolean a) { 231b104340496e3a531e26c8f428c808eca0e039f50San Mehat super(EVENT_UMS_CONNECTION_CHANGED); 232b104340496e3a531e26c8f428c808eca0e039f50San Mehat available = a; 233b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 234b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 235b104340496e3a531e26c8f428c808eca0e039f50San Mehat 236b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 237b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Message sent on volume state change. 238b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 239b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class StorageStateChangedStorageEvent extends StorageEvent { 240b104340496e3a531e26c8f428c808eca0e039f50San Mehat public String path; 241b104340496e3a531e26c8f428c808eca0e039f50San Mehat public String oldState; 242b104340496e3a531e26c8f428c808eca0e039f50San Mehat public String newState; 243b104340496e3a531e26c8f428c808eca0e039f50San Mehat 244b104340496e3a531e26c8f428c808eca0e039f50San Mehat public StorageStateChangedStorageEvent(String p, String oldS, String newS) { 245b104340496e3a531e26c8f428c808eca0e039f50San Mehat super(EVENT_STORAGE_STATE_CHANGED); 246b104340496e3a531e26c8f428c808eca0e039f50San Mehat path = p; 247b104340496e3a531e26c8f428c808eca0e039f50San Mehat oldState = oldS; 248b104340496e3a531e26c8f428c808eca0e039f50San Mehat newState = newS; 249b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 250b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 251b104340496e3a531e26c8f428c808eca0e039f50San Mehat 252b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 253b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Private class containing sender and receiver code for StorageEvents. 254b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 255b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class ListenerDelegate { 256b104340496e3a531e26c8f428c808eca0e039f50San Mehat final StorageEventListener mStorageEventListener; 257b104340496e3a531e26c8f428c808eca0e039f50San Mehat private final Handler mHandler; 258b104340496e3a531e26c8f428c808eca0e039f50San Mehat 259b104340496e3a531e26c8f428c808eca0e039f50San Mehat ListenerDelegate(StorageEventListener listener) { 260b104340496e3a531e26c8f428c808eca0e039f50San Mehat mStorageEventListener = listener; 261b104340496e3a531e26c8f428c808eca0e039f50San Mehat mHandler = new Handler(mTgtLooper) { 262b104340496e3a531e26c8f428c808eca0e039f50San Mehat @Override 263b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void handleMessage(Message msg) { 264b104340496e3a531e26c8f428c808eca0e039f50San Mehat StorageEvent e = (StorageEvent) msg.obj; 265b104340496e3a531e26c8f428c808eca0e039f50San Mehat 266b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (msg.what == StorageEvent.EVENT_UMS_CONNECTION_CHANGED) { 267b104340496e3a531e26c8f428c808eca0e039f50San Mehat UmsConnectionChangedStorageEvent ev = (UmsConnectionChangedStorageEvent) e; 268b104340496e3a531e26c8f428c808eca0e039f50San Mehat mStorageEventListener.onUsbMassStorageConnectionChanged(ev.available); 269b104340496e3a531e26c8f428c808eca0e039f50San Mehat } else if (msg.what == StorageEvent.EVENT_STORAGE_STATE_CHANGED) { 270b104340496e3a531e26c8f428c808eca0e039f50San Mehat StorageStateChangedStorageEvent ev = (StorageStateChangedStorageEvent) e; 271b104340496e3a531e26c8f428c808eca0e039f50San Mehat mStorageEventListener.onStorageStateChanged(ev.path, ev.oldState, ev.newState); 272b104340496e3a531e26c8f428c808eca0e039f50San Mehat } else { 273b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Unsupported event " + msg.what); 274b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 275b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 276b104340496e3a531e26c8f428c808eca0e039f50San Mehat }; 277b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 278b104340496e3a531e26c8f428c808eca0e039f50San Mehat 279b104340496e3a531e26c8f428c808eca0e039f50San Mehat StorageEventListener getListener() { 280b104340496e3a531e26c8f428c808eca0e039f50San Mehat return mStorageEventListener; 281b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 282b104340496e3a531e26c8f428c808eca0e039f50San Mehat 283b104340496e3a531e26c8f428c808eca0e039f50San Mehat void sendShareAvailabilityChanged(boolean available) { 284b104340496e3a531e26c8f428c808eca0e039f50San Mehat UmsConnectionChangedStorageEvent e = new UmsConnectionChangedStorageEvent(available); 285b104340496e3a531e26c8f428c808eca0e039f50San Mehat mHandler.sendMessage(e.getMessage()); 286b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 287b104340496e3a531e26c8f428c808eca0e039f50San Mehat 288b104340496e3a531e26c8f428c808eca0e039f50San Mehat void sendStorageStateChanged(String path, String oldState, String newState) { 289b104340496e3a531e26c8f428c808eca0e039f50San Mehat StorageStateChangedStorageEvent e = new StorageStateChangedStorageEvent(path, oldState, newState); 290b104340496e3a531e26c8f428c808eca0e039f50San Mehat mHandler.sendMessage(e.getMessage()); 291b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 292b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 293b104340496e3a531e26c8f428c808eca0e039f50San Mehat 294b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey /** {@hide} */ 295b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey public static StorageManager from(Context context) { 296b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey return (StorageManager) context.getSystemService(Context.STORAGE_SERVICE); 297b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 298b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey 299b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 300b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Constructs a StorageManager object through which an application can 301b104340496e3a531e26c8f428c808eca0e039f50San Mehat * can communicate with the systems mount service. 302b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 303a45746efadd11bb7dfab026fb3c81a25fae74ca4Jeff Smith * @param tgtLooper The {@link android.os.Looper} which events will be received on. 304b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 305b104340496e3a531e26c8f428c808eca0e039f50San Mehat * <p>Applications can get instance of this class by calling 306b104340496e3a531e26c8f428c808eca0e039f50San Mehat * {@link android.content.Context#getSystemService(java.lang.String)} with an argument 307b104340496e3a531e26c8f428c808eca0e039f50San Mehat * of {@link android.content.Context#STORAGE_SERVICE}. 308b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 309b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @hide 310b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 311b104340496e3a531e26c8f428c808eca0e039f50San Mehat public StorageManager(Looper tgtLooper) throws RemoteException { 312b104340496e3a531e26c8f428c808eca0e039f50San Mehat mMountService = IMountService.Stub.asInterface(ServiceManager.getService("mount")); 313b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (mMountService == null) { 314b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Unable to connect to mount service! - is it running yet?"); 315b104340496e3a531e26c8f428c808eca0e039f50San Mehat return; 316b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 317b104340496e3a531e26c8f428c808eca0e039f50San Mehat mTgtLooper = tgtLooper; 318b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 319b104340496e3a531e26c8f428c808eca0e039f50San Mehat 320b104340496e3a531e26c8f428c808eca0e039f50San Mehat 321b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 322b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Registers a {@link android.os.storage.StorageEventListener StorageEventListener}. 323b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 324b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @param listener A {@link android.os.storage.StorageEventListener StorageEventListener} object. 325b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 326ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 327b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 328b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void registerListener(StorageEventListener listener) { 329b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (listener == null) { 330b104340496e3a531e26c8f428c808eca0e039f50San Mehat return; 331b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 332b104340496e3a531e26c8f428c808eca0e039f50San Mehat 333b104340496e3a531e26c8f428c808eca0e039f50San Mehat synchronized (mListeners) { 3346614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong if (mBinderListener == null ) { 3356614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong try { 3366614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong mBinderListener = new MountServiceBinderListener(); 3376614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong mMountService.registerListener(mBinderListener); 3386614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } catch (RemoteException rex) { 3396614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong Log.e(TAG, "Register mBinderListener failed"); 3406614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong return; 3416614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 3426614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 343b104340496e3a531e26c8f428c808eca0e039f50San Mehat mListeners.add(new ListenerDelegate(listener)); 344b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 345b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 346b104340496e3a531e26c8f428c808eca0e039f50San Mehat 347b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 348b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Unregisters a {@link android.os.storage.StorageEventListener StorageEventListener}. 349b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 350b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @param listener A {@link android.os.storage.StorageEventListener StorageEventListener} object. 351b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 352ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 353b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 354b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void unregisterListener(StorageEventListener listener) { 355b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (listener == null) { 356b104340496e3a531e26c8f428c808eca0e039f50San Mehat return; 357b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 358b104340496e3a531e26c8f428c808eca0e039f50San Mehat 359b104340496e3a531e26c8f428c808eca0e039f50San Mehat synchronized (mListeners) { 360b104340496e3a531e26c8f428c808eca0e039f50San Mehat final int size = mListeners.size(); 361b104340496e3a531e26c8f428c808eca0e039f50San Mehat for (int i=0 ; i<size ; i++) { 362b104340496e3a531e26c8f428c808eca0e039f50San Mehat ListenerDelegate l = mListeners.get(i); 363b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (l.getListener() == listener) { 364b104340496e3a531e26c8f428c808eca0e039f50San Mehat mListeners.remove(i); 365b104340496e3a531e26c8f428c808eca0e039f50San Mehat break; 366b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 367b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 3686614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong if (mListeners.size() == 0 && mBinderListener != null) { 3696614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong try { 3706614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong mMountService.unregisterListener(mBinderListener); 3716614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } catch (RemoteException rex) { 3726614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong Log.e(TAG, "Unregister mBinderListener failed"); 3736614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong return; 3746614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 3756614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 3766614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 377b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 378b104340496e3a531e26c8f428c808eca0e039f50San Mehat 379b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 380b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Enables USB Mass Storage (UMS) on the device. 381ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * 382ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 383b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 3840eec21d97d9dc4eb4fdbad0e4c0fc53703452d02Suchi Amalapurapu public void enableUsbMassStorage() { 385b104340496e3a531e26c8f428c808eca0e039f50San Mehat try { 3860eec21d97d9dc4eb4fdbad0e4c0fc53703452d02Suchi Amalapurapu mMountService.setUsbMassStorageEnabled(true); 387b104340496e3a531e26c8f428c808eca0e039f50San Mehat } catch (Exception ex) { 388b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Failed to enable UMS", ex); 389b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 390b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 391b104340496e3a531e26c8f428c808eca0e039f50San Mehat 392b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 393b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Disables USB Mass Storage (UMS) on the device. 394ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * 395ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 396b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 3970eec21d97d9dc4eb4fdbad0e4c0fc53703452d02Suchi Amalapurapu public void disableUsbMassStorage() { 398b104340496e3a531e26c8f428c808eca0e039f50San Mehat try { 3990eec21d97d9dc4eb4fdbad0e4c0fc53703452d02Suchi Amalapurapu mMountService.setUsbMassStorageEnabled(false); 400b104340496e3a531e26c8f428c808eca0e039f50San Mehat } catch (Exception ex) { 401b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Failed to disable UMS", ex); 402b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 403b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 404b104340496e3a531e26c8f428c808eca0e039f50San Mehat 405b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 406b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Query if a USB Mass Storage (UMS) host is connected. 407b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @return true if UMS host is connected. 408ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * 409ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 410b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 411b104340496e3a531e26c8f428c808eca0e039f50San Mehat public boolean isUsbMassStorageConnected() { 412b104340496e3a531e26c8f428c808eca0e039f50San Mehat try { 413b104340496e3a531e26c8f428c808eca0e039f50San Mehat return mMountService.isUsbMassStorageConnected(); 414b104340496e3a531e26c8f428c808eca0e039f50San Mehat } catch (Exception ex) { 415b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Failed to get UMS connection state", ex); 416b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 417b104340496e3a531e26c8f428c808eca0e039f50San Mehat return false; 418b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 419b104340496e3a531e26c8f428c808eca0e039f50San Mehat 420b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 421b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Query if a USB Mass Storage (UMS) is enabled on the device. 422b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @return true if UMS host is enabled. 423ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * 424ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 425b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 426b104340496e3a531e26c8f428c808eca0e039f50San Mehat public boolean isUsbMassStorageEnabled() { 427b104340496e3a531e26c8f428c808eca0e039f50San Mehat try { 428b104340496e3a531e26c8f428c808eca0e039f50San Mehat return mMountService.isUsbMassStorageEnabled(); 429b104340496e3a531e26c8f428c808eca0e039f50San Mehat } catch (RemoteException rex) { 430b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Failed to get UMS enable state", rex); 431b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 432b104340496e3a531e26c8f428c808eca0e039f50San Mehat return false; 433b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 43402c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 43502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root /** 436a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * Mount an Opaque Binary Blob (OBB) file. If a <code>key</code> is 437a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * specified, it is supplied to the mounting process to be used in any 438a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * encryption used in the OBB. 439a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * <p> 44005105f7abe02b2dff91d6260b3628c8b97816babKenny Root * The OBB will remain mounted for as long as the StorageManager reference 44105105f7abe02b2dff91d6260b3628c8b97816babKenny Root * is held by the application. As soon as this reference is lost, the OBBs 442af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * in use will be unmounted. The {@link OnObbStateChangeListener} registered 443af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * with this call will receive the success or failure of this operation. 44405105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <p> 445a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * <em>Note:</em> you can only mount OBB files for which the OBB tag on the 446a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * file matches a package ID that is owned by the calling program's UID. 44705105f7abe02b2dff91d6260b3628c8b97816babKenny Root * That is, shared UID applications can attempt to mount any other 448a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * application's OBB that shares its UID. 449a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * 4504fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey * @param rawPath the path to the OBB file 45105105f7abe02b2dff91d6260b3628c8b97816babKenny Root * @param key secret used to encrypt the OBB; may be <code>null</code> if no 45205105f7abe02b2dff91d6260b3628c8b97816babKenny Root * encryption was used on the OBB. 453af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * @param listener will receive the success or failure of the operation 454a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @return whether the mount call was successfully queued or not 45502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root */ 4564fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey public boolean mountObb(String rawPath, String key, OnObbStateChangeListener listener) { 4574fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey Preconditions.checkNotNull(rawPath, "rawPath cannot be null"); 4584fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey Preconditions.checkNotNull(listener, "listener cannot be null"); 459af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 46002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root try { 4614fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey final String canonicalPath = new File(rawPath).getCanonicalPath(); 462af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final int nonce = mObbActionListener.addListener(listener); 4634fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey mMountService.mountObb(rawPath, canonicalPath, key, mObbActionListener, nonce); 464a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root return true; 4654fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey } catch (IOException e) { 4664fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey throw new IllegalArgumentException("Failed to resolve path: " + rawPath, e); 46702c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } catch (RemoteException e) { 46802c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root Log.e(TAG, "Failed to mount OBB", e); 46902c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 47002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 47102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return false; 47202c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 47302c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 47402c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root /** 47505105f7abe02b2dff91d6260b3628c8b97816babKenny Root * Unmount an Opaque Binary Blob (OBB) file asynchronously. If the 47605105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <code>force</code> flag is true, it will kill any application needed to 47705105f7abe02b2dff91d6260b3628c8b97816babKenny Root * unmount the given OBB (even the calling application). 47805105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <p> 479af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * The {@link OnObbStateChangeListener} registered with this call will 480af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * receive the success or failure of this operation. 481a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * <p> 482a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * <em>Note:</em> you can only mount OBB files for which the OBB tag on the 483a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * file matches a package ID that is owned by the calling program's UID. 484a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * That is, shared UID applications can obtain access to any other 485a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * application's OBB that shares its UID. 48602ca31fbae9f35dd30f79de6927fae11b549391aKenny Root * <p> 487a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * 4884fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey * @param rawPath path to the OBB file 489a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @param force whether to kill any programs using this in order to unmount 490a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * it 491af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * @param listener will receive the success or failure of the operation 492a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @return whether the unmount call was successfully queued or not 49302c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root */ 4944fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey public boolean unmountObb(String rawPath, boolean force, OnObbStateChangeListener listener) { 4954fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey Preconditions.checkNotNull(rawPath, "rawPath cannot be null"); 4964fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey Preconditions.checkNotNull(listener, "listener cannot be null"); 497af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 49802c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root try { 499af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final int nonce = mObbActionListener.addListener(listener); 5004fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey mMountService.unmountObb(rawPath, force, mObbActionListener, nonce); 501a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root return true; 50202c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } catch (RemoteException e) { 50302c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root Log.e(TAG, "Failed to mount OBB", e); 50402c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 50502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 50602c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return false; 50702c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 50802c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 509a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root /** 510a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * Check whether an Opaque Binary Blob (OBB) is mounted or not. 511a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * 5124fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey * @param rawPath path to OBB image 513a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @return true if OBB is mounted; false if not mounted or on error 514a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root */ 5154fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey public boolean isObbMounted(String rawPath) { 5164fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey Preconditions.checkNotNull(rawPath, "rawPath cannot be null"); 517af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 51802c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root try { 5194fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey return mMountService.isObbMounted(rawPath); 52002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } catch (RemoteException e) { 52102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root Log.e(TAG, "Failed to check if OBB is mounted", e); 52202c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 52302c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 52402c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return false; 52502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 52602c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 52702c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root /** 528a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * Check the mounted path of an Opaque Binary Blob (OBB) file. This will 529a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * give you the path to where you can obtain access to the internals of the 530a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * OBB. 531a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * 5324fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey * @param rawPath path to OBB image 533a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @return absolute path to mounted OBB image data or <code>null</code> if 534a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * not mounted or exception encountered trying to read status 53502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root */ 5364fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey public String getMountedObbPath(String rawPath) { 5374fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey Preconditions.checkNotNull(rawPath, "rawPath cannot be null"); 538af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 53902c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root try { 5404fbbda4cecb078bd3867f416b02cc75f5455284fJeff Sharkey return mMountService.getMountedObbPath(rawPath); 54102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } catch (RemoteException e) { 54202c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root Log.e(TAG, "Failed to find mounted path for OBB", e); 54302c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 54402c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 54502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return null; 54602c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 547d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood 548d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood /** 549d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood * Gets the state of a volume via its mountpoint. 550d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood * @hide 551d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood */ 552d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood public String getVolumeState(String mountPoint) { 553cba928cef7d614d375253246f014c4a52bb8b913Mike Lockwood if (mMountService == null) return Environment.MEDIA_REMOVED; 554d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood try { 555d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood return mMountService.getVolumeState(mountPoint); 556d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } catch (RemoteException e) { 557d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood Log.e(TAG, "Failed to get volume state", e); 558d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood return null; 559d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } 560d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } 561d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood 562d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood /** 563d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood * Returns list of all mountable volumes. 564d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood * @hide 565d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood */ 5662f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood public StorageVolume[] getVolumeList() { 567cba928cef7d614d375253246f014c4a52bb8b913Mike Lockwood if (mMountService == null) return new StorageVolume[0]; 568d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood try { 5692f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood Parcelable[] list = mMountService.getVolumeList(); 5702f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood if (list == null) return new StorageVolume[0]; 5712f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood int length = list.length; 5722f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood StorageVolume[] result = new StorageVolume[length]; 5732f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood for (int i = 0; i < length; i++) { 5742f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood result[i] = (StorageVolume)list[i]; 5752f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood } 5762f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood return result; 577d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } catch (RemoteException e) { 578d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood Log.e(TAG, "Failed to get volume list", e); 579d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood return null; 580d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } 581d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } 5822f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood 5832f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood /** 5842f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood * Returns list of paths for all mountable volumes. 5852f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood * @hide 5862f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood */ 5872f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood public String[] getVolumePaths() { 5882f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood StorageVolume[] volumes = getVolumeList(); 5892f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood if (volumes == null) return null; 5902f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood int count = volumes.length; 5912f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood String[] paths = new String[count]; 5922f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood for (int i = 0; i < count; i++) { 5932f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood paths[i] = volumes[i].getPath(); 5942f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood } 5952f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood return paths; 5962f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood } 597b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey 598b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey /** {@hide} */ 599b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey public StorageVolume getPrimaryVolume() { 600b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey return getPrimaryVolume(getVolumeList()); 601b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 602b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey 603b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey /** {@hide} */ 604b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey public static StorageVolume getPrimaryVolume(StorageVolume[] volumes) { 605b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey for (StorageVolume volume : volumes) { 606b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey if (volume.isPrimary()) { 607b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey return volume; 608b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 609b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 610b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey Log.w(TAG, "No primary storage defined"); 611b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey return null; 612b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 613b104340496e3a531e26c8f428c808eca0e039f50San Mehat} 614