@nativescript/core
Version:
A JavaScript library providing an easy to use api for interacting with iOS and Android platform APIs.
163 lines • 7.02 kB
JavaScript
import { Trace } from '../trace';
import { getFileExtension } from './common';
import { SDK_VERSION } from './constants';
import { android as AndroidUtils } from './native-helper';
import { topmost } from '../ui/frame/frame-stack';
export { clearInterval, clearTimeout, setInterval, setTimeout } from '../timer';
export * from './common';
export * from './constants';
export * from './debug';
export * from './layout-helper';
export * from './macrotask-scheduler';
export * from './mainthread-helper';
export * from './native-helper';
export * from './types';
const MIN_URI_SHARE_RESTRICTED_APK_VERSION = 24;
export function GC() {
gc();
}
export function releaseNativeObject(object) {
__releaseNativeCounterpart(object);
}
export function openUrl(location) {
const context = AndroidUtils.getApplicationContext();
try {
const intent = new android.content.Intent(android.content.Intent.ACTION_VIEW, android.net.Uri.parse(location.trim()));
intent.addFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
}
catch (e) {
// We don't do anything with an error. We just output it
Trace.write(`Failed to start activity for handling URL: ${location}`, Trace.categories.Error, Trace.messageType.error);
return false;
}
return true;
}
/**
* Check whether external storage is read only
*
* @returns {boolean} whether the external storage is read only
*/
function isExternalStorageReadOnly() {
const extStorageState = android.os.Environment.getExternalStorageState();
if (android.os.Environment.MEDIA_MOUNTED_READ_ONLY === extStorageState) {
return true;
}
return false;
}
/**
* Checks whether external storage is available
*
* @returns {boolean} whether external storage is available
*/
function isExternalStorageAvailable() {
const extStorageState = android.os.Environment.getExternalStorageState();
if (android.os.Environment.MEDIA_MOUNTED === extStorageState) {
return true;
}
return false;
}
/**
* Detect the mimetype of a file at a given path
*
* @param {string} filePath
* @returns {string} mimetype
*/
function getMimeTypeNameFromExtension(filePath) {
const mimeTypeMap = android.webkit.MimeTypeMap.getSingleton();
const extension = getFileExtension(filePath).replace('.', '').toLowerCase();
return mimeTypeMap.getMimeTypeFromExtension(extension);
}
/**
* Open a file
*
* @param {string} filePath
* @returns {boolean} whether opening the file succeeded or not
*/
export function openFile(filePath, title = 'Open File...') {
const context = AndroidUtils.getApplicationContext();
try {
// Ensure external storage is available
if (!isExternalStorageAvailable()) {
Trace.write(`
External storage is unavailable (please check app permissions).
Applications cannot access internal storage of other application on Android (see: https://developer.android.com/guide/topics/data/data-storage).
`, Trace.categories.Error, Trace.messageType.error);
return false;
}
// Ensure external storage is available
if (isExternalStorageReadOnly()) {
Trace.write('External storage is read only', Trace.categories.Error, Trace.messageType.error);
return false;
}
// Determine file mimetype & start creating intent
const mimeType = getMimeTypeNameFromExtension(filePath);
const intent = new android.content.Intent(android.content.Intent.ACTION_VIEW);
const chooserIntent = android.content.Intent.createChooser(intent, title);
intent.addFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK);
chooserIntent.addFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK);
// Android SDK <28 only requires starting the chooser Intent straight forwardly
if (SDK_VERSION < MIN_URI_SHARE_RESTRICTED_APK_VERSION) {
Trace.write(`detected sdk version ${SDK_VERSION} (< ${MIN_URI_SHARE_RESTRICTED_APK_VERSION}), using simple openFile`, Trace.categories.Debug);
intent.setDataAndType(android.net.Uri.fromFile(new java.io.File(filePath)), mimeType);
context.startActivity(chooserIntent);
return true;
}
Trace.write(`detected sdk version ${SDK_VERSION} (>= ${MIN_URI_SHARE_RESTRICTED_APK_VERSION}), using URI openFile`, Trace.categories.Debug);
// Android SDK 24+ introduced file system permissions changes that disallow
// exposing URIs between applications
//
// see: https://developer.android.com/reference/android/os/FileUriExposedException
// see: https://github.com/NativeScript/NativeScript/issues/5661#issuecomment-456405380
const providerName = `${context.getPackageName()}.provider`;
Trace.write(`fully-qualified provider name [${providerName}]`, Trace.categories.Debug);
const apkURI = androidx.core.content.FileProvider.getUriForFile(context, providerName, new java.io.File(filePath));
// Set flags & URI as data type on the view action
intent.addFlags(android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION);
chooserIntent.addFlags(android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION);
// Finish intent setup
intent.setDataAndType(apkURI, mimeType);
context.startActivity(chooserIntent);
return true;
}
catch (err) {
const msg = err.message ? `: ${err.message}` : '';
Trace.write(`Error in openFile${msg}`, Trace.categories.Error, Trace.messageType.error);
if (msg && msg.includes('Attempt to invoke virtual method') && msg.includes('android.content.pm.ProviderInfo.loadXmlMetaData') && msg.includes('on a null object reference')) {
// Alert user to possible fix
Trace.write(`
Please ensure you have your manifest correctly configured with the FileProvider.
(see: https://developer.android.com/reference/android/support/v4/content/FileProvider#ProviderDefinition)
`, Trace.categories.Error);
}
return false;
}
}
export function isRealDevice() {
return AndroidUtils.isRealDevice();
}
export function dismissSoftInput(nativeView) {
AndroidUtils.dismissSoftInput(nativeView);
}
export function dismissKeyboard() {
dismissSoftInput();
const modalDialog = (topmost()?._modalParent ?? topmost()?.modal)?._dialogFragment?.getDialog();
const view = modalDialog ?? AndroidUtils.getCurrentActivity();
if (view) {
const focus = view.getCurrentFocus();
if (focus) {
focus.clearFocus();
}
}
}
export function copyToClipboard(value) {
try {
const clipboard = AndroidUtils.getApplicationContext().getSystemService(android.content.Context.CLIPBOARD_SERVICE);
const clip = android.content.ClipData.newPlainText('Clipboard value', value);
clipboard.setPrimaryClip(clip);
}
catch (err) {
console.log(err);
}
}
//# sourceMappingURL=index.android.js.map