StorageManager.java revision b049e212ab7fe8967893c202efcb30fecfdb82fb
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 3105105f7abe02b2dff91d6260b3628c8b97816babKenny Rootimport java.lang.ref.WeakReference; 32b104340496e3a531e26c8f428c808eca0e039f50San Mehatimport java.util.ArrayList; 3305105f7abe02b2dff91d6260b3628c8b97816babKenny Rootimport java.util.List; 34af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Rootimport java.util.concurrent.atomic.AtomicInteger; 35b104340496e3a531e26c8f428c808eca0e039f50San Mehat 36b104340496e3a531e26c8f428c808eca0e039f50San Mehat/** 3705105f7abe02b2dff91d6260b3628c8b97816babKenny Root * StorageManager is the interface to the systems storage service. The storage 3805105f7abe02b2dff91d6260b3628c8b97816babKenny Root * manager handles storage-related items such as Opaque Binary Blobs (OBBs). 3905105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <p> 4005105f7abe02b2dff91d6260b3628c8b97816babKenny Root * OBBs contain a filesystem that maybe be encrypted on disk and mounted 4105105f7abe02b2dff91d6260b3628c8b97816babKenny Root * on-demand from an application. OBBs are a good way of providing large amounts 4205105f7abe02b2dff91d6260b3628c8b97816babKenny Root * of binary assets without packaging them into APKs as they may be multiple 4305105f7abe02b2dff91d6260b3628c8b97816babKenny Root * gigabytes in size. However, due to their size, they're most likely stored in 4405105f7abe02b2dff91d6260b3628c8b97816babKenny Root * a shared storage pool accessible from all programs. The system does not 4505105f7abe02b2dff91d6260b3628c8b97816babKenny Root * guarantee the security of the OBB file itself: if any program modifies the 4605105f7abe02b2dff91d6260b3628c8b97816babKenny Root * OBB, there is no guarantee that a read from that OBB will produce the 4705105f7abe02b2dff91d6260b3628c8b97816babKenny Root * expected output. 4805105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <p> 49b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Get an instance of this class by calling 5005105f7abe02b2dff91d6260b3628c8b97816babKenny Root * {@link android.content.Context#getSystemService(java.lang.String)} with an 5105105f7abe02b2dff91d6260b3628c8b97816babKenny Root * argument of {@link android.content.Context#STORAGE_SERVICE}. 52b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 53b104340496e3a531e26c8f428c808eca0e039f50San Mehat 54b104340496e3a531e26c8f428c808eca0e039f50San Mehatpublic class StorageManager 55b104340496e3a531e26c8f428c808eca0e039f50San Mehat{ 56b104340496e3a531e26c8f428c808eca0e039f50San Mehat private static final String TAG = "StorageManager"; 57b104340496e3a531e26c8f428c808eca0e039f50San Mehat 58b104340496e3a531e26c8f428c808eca0e039f50San Mehat /* 59b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Our internal MountService binder reference 60b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 616614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong final private IMountService mMountService; 62b104340496e3a531e26c8f428c808eca0e039f50San Mehat 63b104340496e3a531e26c8f428c808eca0e039f50San Mehat /* 64b104340496e3a531e26c8f428c808eca0e039f50San Mehat * The looper target for callbacks 65b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 66b104340496e3a531e26c8f428c808eca0e039f50San Mehat Looper mTgtLooper; 67b104340496e3a531e26c8f428c808eca0e039f50San Mehat 68b104340496e3a531e26c8f428c808eca0e039f50San Mehat /* 69b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Target listener for binder callbacks 70b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 71b104340496e3a531e26c8f428c808eca0e039f50San Mehat private MountServiceBinderListener mBinderListener; 72b104340496e3a531e26c8f428c808eca0e039f50San Mehat 73b104340496e3a531e26c8f428c808eca0e039f50San Mehat /* 74b104340496e3a531e26c8f428c808eca0e039f50San Mehat * List of our listeners 75b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 76af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root private List<ListenerDelegate> mListeners = new ArrayList<ListenerDelegate>(); 77af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 78af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root /* 79af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * Next available nonce 80af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root */ 81af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final private AtomicInteger mNextNonce = new AtomicInteger(0); 82b104340496e3a531e26c8f428c808eca0e039f50San Mehat 83b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class MountServiceBinderListener extends IMountServiceListener.Stub { 84b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void onUsbMassStorageConnectionChanged(boolean available) { 85b104340496e3a531e26c8f428c808eca0e039f50San Mehat final int size = mListeners.size(); 86b104340496e3a531e26c8f428c808eca0e039f50San Mehat for (int i = 0; i < size; i++) { 87b104340496e3a531e26c8f428c808eca0e039f50San Mehat mListeners.get(i).sendShareAvailabilityChanged(available); 88b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 89b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 90b104340496e3a531e26c8f428c808eca0e039f50San Mehat 91b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void onStorageStateChanged(String path, String oldState, String newState) { 92b104340496e3a531e26c8f428c808eca0e039f50San Mehat final int size = mListeners.size(); 93b104340496e3a531e26c8f428c808eca0e039f50San Mehat for (int i = 0; i < size; i++) { 94b104340496e3a531e26c8f428c808eca0e039f50San Mehat mListeners.get(i).sendStorageStateChanged(path, oldState, newState); 95b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 96b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 97b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 98b104340496e3a531e26c8f428c808eca0e039f50San Mehat 99b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 100a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * Binder listener for OBB action results. 101a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root */ 10205105f7abe02b2dff91d6260b3628c8b97816babKenny Root private final ObbActionListener mObbActionListener = new ObbActionListener(); 10305105f7abe02b2dff91d6260b3628c8b97816babKenny Root 10405105f7abe02b2dff91d6260b3628c8b97816babKenny Root private class ObbActionListener extends IObbActionListener.Stub { 10537051cdd8624c4821bb68169be427061c48ad837Gilles Debunne @SuppressWarnings("hiding") 106af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root private SparseArray<ObbListenerDelegate> mListeners = new SparseArray<ObbListenerDelegate>(); 10705105f7abe02b2dff91d6260b3628c8b97816babKenny Root 108a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root @Override 10937051cdd8624c4821bb68169be427061c48ad837Gilles Debunne public void onObbResult(String filename, int nonce, int status) { 110af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final ObbListenerDelegate delegate; 11105105f7abe02b2dff91d6260b3628c8b97816babKenny Root synchronized (mListeners) { 112af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root delegate = mListeners.get(nonce); 113af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (delegate != null) { 114af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root mListeners.remove(nonce); 11505105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 11605105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 11705105f7abe02b2dff91d6260b3628c8b97816babKenny Root 118af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (delegate != null) { 119af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root delegate.sendObbStateChanged(filename, status); 12005105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 121af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 12205105f7abe02b2dff91d6260b3628c8b97816babKenny Root 123af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root public int addListener(OnObbStateChangeListener listener) { 124af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final ObbListenerDelegate delegate = new ObbListenerDelegate(listener); 12505105f7abe02b2dff91d6260b3628c8b97816babKenny Root 126af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root synchronized (mListeners) { 127af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root mListeners.put(delegate.nonce, delegate); 12805105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 129af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 130af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root return delegate.nonce; 13105105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 13205105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 13305105f7abe02b2dff91d6260b3628c8b97816babKenny Root 134af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root private int getNextNonce() { 135af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root return mNextNonce.getAndIncrement(); 136af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 137af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 13805105f7abe02b2dff91d6260b3628c8b97816babKenny Root /** 13905105f7abe02b2dff91d6260b3628c8b97816babKenny Root * Private class containing sender and receiver code for StorageEvents. 14005105f7abe02b2dff91d6260b3628c8b97816babKenny Root */ 14105105f7abe02b2dff91d6260b3628c8b97816babKenny Root private class ObbListenerDelegate { 14205105f7abe02b2dff91d6260b3628c8b97816babKenny Root private final WeakReference<OnObbStateChangeListener> mObbEventListenerRef; 14305105f7abe02b2dff91d6260b3628c8b97816babKenny Root private final Handler mHandler; 14405105f7abe02b2dff91d6260b3628c8b97816babKenny Root 145af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root private final int nonce; 146af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 14705105f7abe02b2dff91d6260b3628c8b97816babKenny Root ObbListenerDelegate(OnObbStateChangeListener listener) { 148af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root nonce = getNextNonce(); 14905105f7abe02b2dff91d6260b3628c8b97816babKenny Root mObbEventListenerRef = new WeakReference<OnObbStateChangeListener>(listener); 15005105f7abe02b2dff91d6260b3628c8b97816babKenny Root mHandler = new Handler(mTgtLooper) { 15105105f7abe02b2dff91d6260b3628c8b97816babKenny Root @Override 15205105f7abe02b2dff91d6260b3628c8b97816babKenny Root public void handleMessage(Message msg) { 15337051cdd8624c4821bb68169be427061c48ad837Gilles Debunne final OnObbStateChangeListener changeListener = getListener(); 15437051cdd8624c4821bb68169be427061c48ad837Gilles Debunne if (changeListener == null) { 15505105f7abe02b2dff91d6260b3628c8b97816babKenny Root return; 15605105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 15705105f7abe02b2dff91d6260b3628c8b97816babKenny Root 15805105f7abe02b2dff91d6260b3628c8b97816babKenny Root StorageEvent e = (StorageEvent) msg.obj; 15905105f7abe02b2dff91d6260b3628c8b97816babKenny Root 16005105f7abe02b2dff91d6260b3628c8b97816babKenny Root if (msg.what == StorageEvent.EVENT_OBB_STATE_CHANGED) { 16105105f7abe02b2dff91d6260b3628c8b97816babKenny Root ObbStateChangedStorageEvent ev = (ObbStateChangedStorageEvent) e; 16237051cdd8624c4821bb68169be427061c48ad837Gilles Debunne changeListener.onObbStateChange(ev.path, ev.state); 16305105f7abe02b2dff91d6260b3628c8b97816babKenny Root } else { 16405105f7abe02b2dff91d6260b3628c8b97816babKenny Root Log.e(TAG, "Unsupported event " + msg.what); 16505105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 16605105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 16705105f7abe02b2dff91d6260b3628c8b97816babKenny Root }; 16805105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 16905105f7abe02b2dff91d6260b3628c8b97816babKenny Root 17005105f7abe02b2dff91d6260b3628c8b97816babKenny Root OnObbStateChangeListener getListener() { 17105105f7abe02b2dff91d6260b3628c8b97816babKenny Root if (mObbEventListenerRef == null) { 17205105f7abe02b2dff91d6260b3628c8b97816babKenny Root return null; 17305105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 17405105f7abe02b2dff91d6260b3628c8b97816babKenny Root return mObbEventListenerRef.get(); 17505105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 17605105f7abe02b2dff91d6260b3628c8b97816babKenny Root 177af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root void sendObbStateChanged(String path, int state) { 17805105f7abe02b2dff91d6260b3628c8b97816babKenny Root ObbStateChangedStorageEvent e = new ObbStateChangedStorageEvent(path, state); 17905105f7abe02b2dff91d6260b3628c8b97816babKenny Root mHandler.sendMessage(e.getMessage()); 18005105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 18105105f7abe02b2dff91d6260b3628c8b97816babKenny Root } 18205105f7abe02b2dff91d6260b3628c8b97816babKenny Root 18305105f7abe02b2dff91d6260b3628c8b97816babKenny Root /** 18405105f7abe02b2dff91d6260b3628c8b97816babKenny Root * Message sent during an OBB status change event. 18505105f7abe02b2dff91d6260b3628c8b97816babKenny Root */ 18605105f7abe02b2dff91d6260b3628c8b97816babKenny Root private class ObbStateChangedStorageEvent extends StorageEvent { 18705105f7abe02b2dff91d6260b3628c8b97816babKenny Root public final String path; 18805105f7abe02b2dff91d6260b3628c8b97816babKenny Root 189af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root public final int state; 190af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 191af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root public ObbStateChangedStorageEvent(String path, int state) { 19205105f7abe02b2dff91d6260b3628c8b97816babKenny Root super(EVENT_OBB_STATE_CHANGED); 19305105f7abe02b2dff91d6260b3628c8b97816babKenny Root this.path = path; 19405105f7abe02b2dff91d6260b3628c8b97816babKenny Root this.state = state; 195a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root } 196a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root } 197a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root 198a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root /** 199b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Private base class for messages sent between the callback thread 200b104340496e3a531e26c8f428c808eca0e039f50San Mehat * and the target looper handler. 201b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 202b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class StorageEvent { 20305105f7abe02b2dff91d6260b3628c8b97816babKenny Root static final int EVENT_UMS_CONNECTION_CHANGED = 1; 20405105f7abe02b2dff91d6260b3628c8b97816babKenny Root static final int EVENT_STORAGE_STATE_CHANGED = 2; 20505105f7abe02b2dff91d6260b3628c8b97816babKenny Root static final int EVENT_OBB_STATE_CHANGED = 3; 206b104340496e3a531e26c8f428c808eca0e039f50San Mehat 207b104340496e3a531e26c8f428c808eca0e039f50San Mehat private Message mMessage; 208b104340496e3a531e26c8f428c808eca0e039f50San Mehat 209b104340496e3a531e26c8f428c808eca0e039f50San Mehat public StorageEvent(int what) { 210b104340496e3a531e26c8f428c808eca0e039f50San Mehat mMessage = Message.obtain(); 211b104340496e3a531e26c8f428c808eca0e039f50San Mehat mMessage.what = what; 212b104340496e3a531e26c8f428c808eca0e039f50San Mehat mMessage.obj = this; 213b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 214b104340496e3a531e26c8f428c808eca0e039f50San Mehat 215b104340496e3a531e26c8f428c808eca0e039f50San Mehat public Message getMessage() { 216b104340496e3a531e26c8f428c808eca0e039f50San Mehat return mMessage; 217b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 218b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 219b104340496e3a531e26c8f428c808eca0e039f50San Mehat 220b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 221b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Message sent on a USB mass storage connection change. 222b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 223b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class UmsConnectionChangedStorageEvent extends StorageEvent { 224b104340496e3a531e26c8f428c808eca0e039f50San Mehat public boolean available; 225b104340496e3a531e26c8f428c808eca0e039f50San Mehat 226b104340496e3a531e26c8f428c808eca0e039f50San Mehat public UmsConnectionChangedStorageEvent(boolean a) { 227b104340496e3a531e26c8f428c808eca0e039f50San Mehat super(EVENT_UMS_CONNECTION_CHANGED); 228b104340496e3a531e26c8f428c808eca0e039f50San Mehat available = a; 229b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 230b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 231b104340496e3a531e26c8f428c808eca0e039f50San Mehat 232b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 233b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Message sent on volume state change. 234b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 235b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class StorageStateChangedStorageEvent extends StorageEvent { 236b104340496e3a531e26c8f428c808eca0e039f50San Mehat public String path; 237b104340496e3a531e26c8f428c808eca0e039f50San Mehat public String oldState; 238b104340496e3a531e26c8f428c808eca0e039f50San Mehat public String newState; 239b104340496e3a531e26c8f428c808eca0e039f50San Mehat 240b104340496e3a531e26c8f428c808eca0e039f50San Mehat public StorageStateChangedStorageEvent(String p, String oldS, String newS) { 241b104340496e3a531e26c8f428c808eca0e039f50San Mehat super(EVENT_STORAGE_STATE_CHANGED); 242b104340496e3a531e26c8f428c808eca0e039f50San Mehat path = p; 243b104340496e3a531e26c8f428c808eca0e039f50San Mehat oldState = oldS; 244b104340496e3a531e26c8f428c808eca0e039f50San Mehat newState = newS; 245b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 246b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 247b104340496e3a531e26c8f428c808eca0e039f50San Mehat 248b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 249b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Private class containing sender and receiver code for StorageEvents. 250b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 251b104340496e3a531e26c8f428c808eca0e039f50San Mehat private class ListenerDelegate { 252b104340496e3a531e26c8f428c808eca0e039f50San Mehat final StorageEventListener mStorageEventListener; 253b104340496e3a531e26c8f428c808eca0e039f50San Mehat private final Handler mHandler; 254b104340496e3a531e26c8f428c808eca0e039f50San Mehat 255b104340496e3a531e26c8f428c808eca0e039f50San Mehat ListenerDelegate(StorageEventListener listener) { 256b104340496e3a531e26c8f428c808eca0e039f50San Mehat mStorageEventListener = listener; 257b104340496e3a531e26c8f428c808eca0e039f50San Mehat mHandler = new Handler(mTgtLooper) { 258b104340496e3a531e26c8f428c808eca0e039f50San Mehat @Override 259b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void handleMessage(Message msg) { 260b104340496e3a531e26c8f428c808eca0e039f50San Mehat StorageEvent e = (StorageEvent) msg.obj; 261b104340496e3a531e26c8f428c808eca0e039f50San Mehat 262b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (msg.what == StorageEvent.EVENT_UMS_CONNECTION_CHANGED) { 263b104340496e3a531e26c8f428c808eca0e039f50San Mehat UmsConnectionChangedStorageEvent ev = (UmsConnectionChangedStorageEvent) e; 264b104340496e3a531e26c8f428c808eca0e039f50San Mehat mStorageEventListener.onUsbMassStorageConnectionChanged(ev.available); 265b104340496e3a531e26c8f428c808eca0e039f50San Mehat } else if (msg.what == StorageEvent.EVENT_STORAGE_STATE_CHANGED) { 266b104340496e3a531e26c8f428c808eca0e039f50San Mehat StorageStateChangedStorageEvent ev = (StorageStateChangedStorageEvent) e; 267b104340496e3a531e26c8f428c808eca0e039f50San Mehat mStorageEventListener.onStorageStateChanged(ev.path, ev.oldState, ev.newState); 268b104340496e3a531e26c8f428c808eca0e039f50San Mehat } else { 269b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Unsupported event " + msg.what); 270b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 271b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 272b104340496e3a531e26c8f428c808eca0e039f50San Mehat }; 273b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 274b104340496e3a531e26c8f428c808eca0e039f50San Mehat 275b104340496e3a531e26c8f428c808eca0e039f50San Mehat StorageEventListener getListener() { 276b104340496e3a531e26c8f428c808eca0e039f50San Mehat return mStorageEventListener; 277b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 278b104340496e3a531e26c8f428c808eca0e039f50San Mehat 279b104340496e3a531e26c8f428c808eca0e039f50San Mehat void sendShareAvailabilityChanged(boolean available) { 280b104340496e3a531e26c8f428c808eca0e039f50San Mehat UmsConnectionChangedStorageEvent e = new UmsConnectionChangedStorageEvent(available); 281b104340496e3a531e26c8f428c808eca0e039f50San Mehat mHandler.sendMessage(e.getMessage()); 282b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 283b104340496e3a531e26c8f428c808eca0e039f50San Mehat 284b104340496e3a531e26c8f428c808eca0e039f50San Mehat void sendStorageStateChanged(String path, String oldState, String newState) { 285b104340496e3a531e26c8f428c808eca0e039f50San Mehat StorageStateChangedStorageEvent e = new StorageStateChangedStorageEvent(path, oldState, newState); 286b104340496e3a531e26c8f428c808eca0e039f50San Mehat mHandler.sendMessage(e.getMessage()); 287b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 288b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 289b104340496e3a531e26c8f428c808eca0e039f50San Mehat 290b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey /** {@hide} */ 291b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey public static StorageManager from(Context context) { 292b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey return (StorageManager) context.getSystemService(Context.STORAGE_SERVICE); 293b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 294b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey 295b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 296b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Constructs a StorageManager object through which an application can 297b104340496e3a531e26c8f428c808eca0e039f50San Mehat * can communicate with the systems mount service. 298b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 299a45746efadd11bb7dfab026fb3c81a25fae74ca4Jeff Smith * @param tgtLooper The {@link android.os.Looper} which events will be received on. 300b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 301b104340496e3a531e26c8f428c808eca0e039f50San Mehat * <p>Applications can get instance of this class by calling 302b104340496e3a531e26c8f428c808eca0e039f50San Mehat * {@link android.content.Context#getSystemService(java.lang.String)} with an argument 303b104340496e3a531e26c8f428c808eca0e039f50San Mehat * of {@link android.content.Context#STORAGE_SERVICE}. 304b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 305b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @hide 306b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 307b104340496e3a531e26c8f428c808eca0e039f50San Mehat public StorageManager(Looper tgtLooper) throws RemoteException { 308b104340496e3a531e26c8f428c808eca0e039f50San Mehat mMountService = IMountService.Stub.asInterface(ServiceManager.getService("mount")); 309b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (mMountService == null) { 310b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Unable to connect to mount service! - is it running yet?"); 311b104340496e3a531e26c8f428c808eca0e039f50San Mehat return; 312b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 313b104340496e3a531e26c8f428c808eca0e039f50San Mehat mTgtLooper = tgtLooper; 314b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 315b104340496e3a531e26c8f428c808eca0e039f50San Mehat 316b104340496e3a531e26c8f428c808eca0e039f50San Mehat 317b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 318b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Registers a {@link android.os.storage.StorageEventListener StorageEventListener}. 319b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 320b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @param listener A {@link android.os.storage.StorageEventListener StorageEventListener} object. 321b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 322ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 323b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 324b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void registerListener(StorageEventListener listener) { 325b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (listener == null) { 326b104340496e3a531e26c8f428c808eca0e039f50San Mehat return; 327b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 328b104340496e3a531e26c8f428c808eca0e039f50San Mehat 329b104340496e3a531e26c8f428c808eca0e039f50San Mehat synchronized (mListeners) { 3306614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong if (mBinderListener == null ) { 3316614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong try { 3326614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong mBinderListener = new MountServiceBinderListener(); 3336614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong mMountService.registerListener(mBinderListener); 3346614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } catch (RemoteException rex) { 3356614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong Log.e(TAG, "Register mBinderListener failed"); 3366614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong return; 3376614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 3386614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 339b104340496e3a531e26c8f428c808eca0e039f50San Mehat mListeners.add(new ListenerDelegate(listener)); 340b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 341b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 342b104340496e3a531e26c8f428c808eca0e039f50San Mehat 343b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 344b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Unregisters a {@link android.os.storage.StorageEventListener StorageEventListener}. 345b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 346b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @param listener A {@link android.os.storage.StorageEventListener StorageEventListener} object. 347b104340496e3a531e26c8f428c808eca0e039f50San Mehat * 348ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 349b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 350b104340496e3a531e26c8f428c808eca0e039f50San Mehat public void unregisterListener(StorageEventListener listener) { 351b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (listener == null) { 352b104340496e3a531e26c8f428c808eca0e039f50San Mehat return; 353b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 354b104340496e3a531e26c8f428c808eca0e039f50San Mehat 355b104340496e3a531e26c8f428c808eca0e039f50San Mehat synchronized (mListeners) { 356b104340496e3a531e26c8f428c808eca0e039f50San Mehat final int size = mListeners.size(); 357b104340496e3a531e26c8f428c808eca0e039f50San Mehat for (int i=0 ; i<size ; i++) { 358b104340496e3a531e26c8f428c808eca0e039f50San Mehat ListenerDelegate l = mListeners.get(i); 359b104340496e3a531e26c8f428c808eca0e039f50San Mehat if (l.getListener() == listener) { 360b104340496e3a531e26c8f428c808eca0e039f50San Mehat mListeners.remove(i); 361b104340496e3a531e26c8f428c808eca0e039f50San Mehat break; 362b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 363b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 3646614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong if (mListeners.size() == 0 && mBinderListener != null) { 3656614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong try { 3666614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong mMountService.unregisterListener(mBinderListener); 3676614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } catch (RemoteException rex) { 3686614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong Log.e(TAG, "Unregister mBinderListener failed"); 3696614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong return; 3706614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 3716614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 3726614bb657929c70dad988fb14b4b91f3b9d4f7fcChuanxia Dong } 373b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 374b104340496e3a531e26c8f428c808eca0e039f50San Mehat 375b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 376b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Enables USB Mass Storage (UMS) on the device. 377ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * 378ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 379b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 3800eec21d97d9dc4eb4fdbad0e4c0fc53703452d02Suchi Amalapurapu public void enableUsbMassStorage() { 381b104340496e3a531e26c8f428c808eca0e039f50San Mehat try { 3820eec21d97d9dc4eb4fdbad0e4c0fc53703452d02Suchi Amalapurapu mMountService.setUsbMassStorageEnabled(true); 383b104340496e3a531e26c8f428c808eca0e039f50San Mehat } catch (Exception ex) { 384b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Failed to enable UMS", ex); 385b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 386b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 387b104340496e3a531e26c8f428c808eca0e039f50San Mehat 388b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 389b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Disables USB Mass Storage (UMS) on the device. 390ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * 391ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 392b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 3930eec21d97d9dc4eb4fdbad0e4c0fc53703452d02Suchi Amalapurapu public void disableUsbMassStorage() { 394b104340496e3a531e26c8f428c808eca0e039f50San Mehat try { 3950eec21d97d9dc4eb4fdbad0e4c0fc53703452d02Suchi Amalapurapu mMountService.setUsbMassStorageEnabled(false); 396b104340496e3a531e26c8f428c808eca0e039f50San Mehat } catch (Exception ex) { 397b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Failed to disable UMS", ex); 398b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 399b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 400b104340496e3a531e26c8f428c808eca0e039f50San Mehat 401b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 402b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Query if a USB Mass Storage (UMS) host is connected. 403b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @return true if UMS host is connected. 404ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * 405ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 406b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 407b104340496e3a531e26c8f428c808eca0e039f50San Mehat public boolean isUsbMassStorageConnected() { 408b104340496e3a531e26c8f428c808eca0e039f50San Mehat try { 409b104340496e3a531e26c8f428c808eca0e039f50San Mehat return mMountService.isUsbMassStorageConnected(); 410b104340496e3a531e26c8f428c808eca0e039f50San Mehat } catch (Exception ex) { 411b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Failed to get UMS connection state", ex); 412b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 413b104340496e3a531e26c8f428c808eca0e039f50San Mehat return false; 414b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 415b104340496e3a531e26c8f428c808eca0e039f50San Mehat 416b104340496e3a531e26c8f428c808eca0e039f50San Mehat /** 417b104340496e3a531e26c8f428c808eca0e039f50San Mehat * Query if a USB Mass Storage (UMS) is enabled on the device. 418b104340496e3a531e26c8f428c808eca0e039f50San Mehat * @return true if UMS host is enabled. 419ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * 420ec7c9ff0bb1c98cb8bec3ec7bdacbae3a434fa53Kenny Root * @hide 421b104340496e3a531e26c8f428c808eca0e039f50San Mehat */ 422b104340496e3a531e26c8f428c808eca0e039f50San Mehat public boolean isUsbMassStorageEnabled() { 423b104340496e3a531e26c8f428c808eca0e039f50San Mehat try { 424b104340496e3a531e26c8f428c808eca0e039f50San Mehat return mMountService.isUsbMassStorageEnabled(); 425b104340496e3a531e26c8f428c808eca0e039f50San Mehat } catch (RemoteException rex) { 426b104340496e3a531e26c8f428c808eca0e039f50San Mehat Log.e(TAG, "Failed to get UMS enable state", rex); 427b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 428b104340496e3a531e26c8f428c808eca0e039f50San Mehat return false; 429b104340496e3a531e26c8f428c808eca0e039f50San Mehat } 43002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 43102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root /** 432a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * Mount an Opaque Binary Blob (OBB) file. If a <code>key</code> is 433a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * specified, it is supplied to the mounting process to be used in any 434a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * encryption used in the OBB. 435a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * <p> 43605105f7abe02b2dff91d6260b3628c8b97816babKenny Root * The OBB will remain mounted for as long as the StorageManager reference 43705105f7abe02b2dff91d6260b3628c8b97816babKenny Root * is held by the application. As soon as this reference is lost, the OBBs 438af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * in use will be unmounted. The {@link OnObbStateChangeListener} registered 439af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * with this call will receive the success or failure of this operation. 44005105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <p> 441a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * <em>Note:</em> you can only mount OBB files for which the OBB tag on the 442a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * file matches a package ID that is owned by the calling program's UID. 44305105f7abe02b2dff91d6260b3628c8b97816babKenny Root * That is, shared UID applications can attempt to mount any other 444a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * application's OBB that shares its UID. 445a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * 446a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @param filename the path to the OBB file 44705105f7abe02b2dff91d6260b3628c8b97816babKenny Root * @param key secret used to encrypt the OBB; may be <code>null</code> if no 44805105f7abe02b2dff91d6260b3628c8b97816babKenny Root * encryption was used on the OBB. 449af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * @param listener will receive the success or failure of the operation 450a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @return whether the mount call was successfully queued or not 45102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root */ 45205105f7abe02b2dff91d6260b3628c8b97816babKenny Root public boolean mountObb(String filename, String key, OnObbStateChangeListener listener) { 453af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (filename == null) { 454af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root throw new IllegalArgumentException("filename cannot be null"); 455af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 456af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 457af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (listener == null) { 458af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root throw new IllegalArgumentException("listener cannot be null"); 459af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 460af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 46102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root try { 462af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final int nonce = mObbActionListener.addListener(listener); 463af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root mMountService.mountObb(filename, key, mObbActionListener, nonce); 464a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root return true; 46502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } catch (RemoteException e) { 46602c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root Log.e(TAG, "Failed to mount OBB", e); 46702c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 46802c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 46902c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return false; 47002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 47102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 47202c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root /** 47305105f7abe02b2dff91d6260b3628c8b97816babKenny Root * Unmount an Opaque Binary Blob (OBB) file asynchronously. If the 47405105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <code>force</code> flag is true, it will kill any application needed to 47505105f7abe02b2dff91d6260b3628c8b97816babKenny Root * unmount the given OBB (even the calling application). 47605105f7abe02b2dff91d6260b3628c8b97816babKenny Root * <p> 477af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * The {@link OnObbStateChangeListener} registered with this call will 478af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * receive the success or failure of this operation. 479a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * <p> 480a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * <em>Note:</em> you can only mount OBB files for which the OBB tag on the 481a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * file matches a package ID that is owned by the calling program's UID. 482a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * That is, shared UID applications can obtain access to any other 483a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * application's OBB that shares its UID. 48402ca31fbae9f35dd30f79de6927fae11b549391aKenny Root * <p> 485a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * 486a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @param filename path to the OBB file 487a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @param force whether to kill any programs using this in order to unmount 488a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * it 489af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root * @param listener will receive the success or failure of the operation 490a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @return whether the unmount call was successfully queued or not 49102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root */ 49238cf8867a8d3e8d5159abd0bd0e6a3b0b8348b94Kenny Root public boolean unmountObb(String filename, boolean force, OnObbStateChangeListener listener) { 493af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (filename == null) { 494af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root throw new IllegalArgumentException("filename cannot be null"); 495af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 496af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 497af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (listener == null) { 498af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root throw new IllegalArgumentException("listener cannot be null"); 499af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 500af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 50102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root try { 502af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root final int nonce = mObbActionListener.addListener(listener); 503af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root mMountService.unmountObb(filename, force, mObbActionListener, nonce); 504a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root return true; 50502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } catch (RemoteException e) { 50602c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root Log.e(TAG, "Failed to mount OBB", e); 50702c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 50802c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 50902c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return false; 51002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 51102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 512a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root /** 513a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * Check whether an Opaque Binary Blob (OBB) is mounted or not. 514a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * 515a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @param filename path to OBB image 516a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @return true if OBB is mounted; false if not mounted or on error 517a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root */ 518af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root public boolean isObbMounted(String filename) { 519af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (filename == null) { 520af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root throw new IllegalArgumentException("filename cannot be null"); 521af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 522af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 52302c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root try { 52402c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return mMountService.isObbMounted(filename); 52502c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } catch (RemoteException e) { 52602c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root Log.e(TAG, "Failed to check if OBB is mounted", e); 52702c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 52802c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 52902c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return false; 53002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 53102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 53202c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root /** 533a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * Check the mounted path of an Opaque Binary Blob (OBB) file. This will 534a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * give you the path to where you can obtain access to the internals of the 535a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * OBB. 536a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * 537a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @param filename path to OBB image 538a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * @return absolute path to mounted OBB image data or <code>null</code> if 539a02b8b05dd1e8b8cf169e1f89542ef835b11fc13Kenny Root * not mounted or exception encountered trying to read status 54002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root */ 54102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root public String getMountedObbPath(String filename) { 542af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root if (filename == null) { 543af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root throw new IllegalArgumentException("filename cannot be null"); 544af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root } 545af9d667ccf3e24058214cf4cc0a8aa8bc5100e3cKenny Root 54602c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root try { 54702c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return mMountService.getMountedObbPath(filename); 54802c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } catch (RemoteException e) { 54902c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root Log.e(TAG, "Failed to find mounted path for OBB", e); 55002c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 55102c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root 55202c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root return null; 55302c8730c1bf19daf48bec8c6995df676a00a73b1Kenny Root } 554d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood 555d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood /** 556d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood * Gets the state of a volume via its mountpoint. 557d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood * @hide 558d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood */ 559d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood public String getVolumeState(String mountPoint) { 560cba928cef7d614d375253246f014c4a52bb8b913Mike Lockwood if (mMountService == null) return Environment.MEDIA_REMOVED; 561d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood try { 562d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood return mMountService.getVolumeState(mountPoint); 563d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } catch (RemoteException e) { 564d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood Log.e(TAG, "Failed to get volume state", e); 565d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood return null; 566d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } 567d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } 568d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood 569d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood /** 570d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood * Returns list of all mountable volumes. 571d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood * @hide 572d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood */ 5732f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood public StorageVolume[] getVolumeList() { 574cba928cef7d614d375253246f014c4a52bb8b913Mike Lockwood if (mMountService == null) return new StorageVolume[0]; 575d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood try { 5762f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood Parcelable[] list = mMountService.getVolumeList(); 5772f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood if (list == null) return new StorageVolume[0]; 5782f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood int length = list.length; 5792f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood StorageVolume[] result = new StorageVolume[length]; 5802f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood for (int i = 0; i < length; i++) { 5812f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood result[i] = (StorageVolume)list[i]; 5822f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood } 5832f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood return result; 584d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } catch (RemoteException e) { 585d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood Log.e(TAG, "Failed to get volume list", e); 586d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood return null; 587d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } 588d967f4664f40f9a4c5262a44b19df9bbdf457d8aMike Lockwood } 5892f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood 5902f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood /** 5912f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood * Returns list of paths for all mountable volumes. 5922f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood * @hide 5932f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood */ 5942f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood public String[] getVolumePaths() { 5952f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood StorageVolume[] volumes = getVolumeList(); 5962f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood if (volumes == null) return null; 5972f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood int count = volumes.length; 5982f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood String[] paths = new String[count]; 5992f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood for (int i = 0; i < count; i++) { 6002f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood paths[i] = volumes[i].getPath(); 6012f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood } 6022f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood return paths; 6032f6a3885533a52758c2cd4f81f6123a712be8ae6Mike Lockwood } 604b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey 605b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey /** {@hide} */ 606b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey public StorageVolume getPrimaryVolume() { 607b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey return getPrimaryVolume(getVolumeList()); 608b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 609b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey 610b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey /** {@hide} */ 611b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey public static StorageVolume getPrimaryVolume(StorageVolume[] volumes) { 612b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey for (StorageVolume volume : volumes) { 613b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey if (volume.isPrimary()) { 614b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey return volume; 615b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 616b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 617b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey Log.w(TAG, "No primary storage defined"); 618b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey return null; 619b049e212ab7fe8967893c202efcb30fecfdb82fbJeff Sharkey } 620b104340496e3a531e26c8f428c808eca0e039f50San Mehat} 621