a2209ddd5e
Previously, termux only supported getting result of BACKGROUND commands back if they were started via Termux:Tasker plugin. Getting back result of foreground commands was not possible with any way. Now with RUN_COMMAND intent or Termux:Tasker, the third party apps and users can get the foreground command results as well. Note that by "foreground results" we only mean the session transcript. The session transcript will contain both stdout and stderr combined, basically anything sent to the the pseudo terminal /dev/pts, including PS1 prefixes for interactive sessions. Getting separate stdout and stderr can currently only be done with background commands. Moreover, with RUN_COMMAND intent, third party apps and users can get the background commands results as well. This means separate extras for stdout and stderr. The exit code will also be returned for either case. ### RUN_COMMAND intent The result extras are returned in the TERMUX_SERVICE.EXTRA_PLUGIN_RESULT_BUNDLE bundle via the pending intent received. The RUN_COMMAND_SERVICE.EXTRA_PENDING_INTENT extra can be used to send the pending intent with which termux should return the result bundle. The pending intent can be received back by the app with an IntentService. Check RunCommandService for reference implementation. For foreground commands (RUN_COMMAND_SERVICE.EXTRA_BACKGROUND is false): - EXTRA_PLUGIN_RESULT_BUNDLE_STDOUT will contain session transcript. - EXTRA_PLUGIN_RESULT_BUNDLE_STDERR will be null since its not used. - EXTRA_PLUGIN_RESULT_BUNDLE_EXIT_CODE will contain exit code of session. For background commands (RUN_COMMAND_SERVICE.EXTRA_BACKGROUND is true): - EXTRA_PLUGIN_RESULT_BUNDLE_STDOUT will contain stdout of commands. - EXTRA_PLUGIN_RESULT_BUNDLE_STDERR will contain stderr of commands. - EXTRA_PLUGIN_RESULT_BUNDLE_EXIT_CODE will contain exit code of command. The internal errors raised by termux outside the shell will be sent in the the EXTRA_PLUGIN_RESULT_BUNDLE_ERR and EXTRA_PLUGIN_RESULT_BUNDLE_ERRMSG extras. These will contain errors like if starting a termux command failed or if the user manually exited the termux sessions or android killed the termux service before the commands had finished executing. The err value will be Activity.RESULT_OK(-1) if no internal errors are raised. The stdout and stderr will be truncated from the start to max 100KB combined and errmsg will also be truncated from end to max 25KB. This is necessary to prevent TransactionTooLargeException exceptions from being raised if stdout or stderr are too large in length. The original length of stdout and stderr will be provided in EXTRA_PLUGIN_RESULT_BUNDLE_STDOUT_ORIGINAL_LENGTH and EXTRA_PLUGIN_RESULT_BUNDLE_STDERR_ORIGINAL_LENGTH extras respectively, so that the caller can check if either of them were truncated. ### Termux:Tasker Support for Termux:Tasker for getting back result of foreground commands will require an update to it since it currently immediately returns control to plugin host app like Tasker without waiting if a foreground command is to be executed.
176 lines
9.4 KiB
XML
176 lines
9.4 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
|
|
<!DOCTYPE resources [
|
|
<!ENTITY TERMUX_PACKAGE_NAME "com.termux">
|
|
<!ENTITY TERMUX_APP_NAME "Termux">
|
|
<!ENTITY TERMUX_API_APP_NAME "Termux:API">
|
|
<!ENTITY TERMUX_BOOT_APP_NAME "Termux:Boot">
|
|
<!ENTITY TERMUX_FLOAT_APP_NAME "Termux:Float">
|
|
<!ENTITY TERMUX_STYLING_APP_NAME "Termux:Styling">
|
|
<!ENTITY TERMUX_TASKER_APP_NAME "Termux:Tasker">
|
|
<!ENTITY TERMUX_WIDGET_APP_NAME "Termux:Widget">
|
|
<!ENTITY TERMUX_PROPERTIES_PRIMARY_PATH_SHORT "~/.termux/termux.properties">
|
|
]>
|
|
|
|
<resources>
|
|
<string name="application_name">&TERMUX_APP_NAME;</string>
|
|
<string name="shared_user_label">&TERMUX_APP_NAME; user</string>
|
|
|
|
|
|
|
|
<!-- Termux RUN_COMMAND permission -->
|
|
<string name="permission_run_command_label">Run commands in &TERMUX_APP_NAME; environment</string>
|
|
<string name="permission_run_command_description">execute arbitrary commands within &TERMUX_APP_NAME;
|
|
environment</string>
|
|
|
|
|
|
|
|
<!-- Termux Bootstrap Packages Installation -->
|
|
<string name="bootstrap_installer_body">Installing bootstrap packages…</string>
|
|
<string name="bootstrap_error_title">Unable to install bootstrap</string>
|
|
<string name="bootstrap_error_body">&TERMUX_APP_NAME; was unable to install the bootstrap packages.</string>
|
|
<string name="bootstrap_error_abort">Abort</string>
|
|
<string name="bootstrap_error_try_again">Try again</string>
|
|
<string name="bootstrap_error_not_primary_user_message">&TERMUX_APP_NAME; can only be run as the primary user.\nBootstrap binaries compiled for &TERMUX_APP_NAME; have hardcoded $PREFIX path and cannot be installed under any path other than \"%1$s\".</string>
|
|
|
|
|
|
|
|
<!-- Terminal Sidebar and Shortcuts -->
|
|
<string name="action_new_session">New session</string>
|
|
<string name="action_new_session_failsafe">Failsafe</string>
|
|
<string name="title_max_terminals_reached">Max terminals reached</string>
|
|
<string name="msg_max_terminals_reached">Close down existing ones before creating new.</string>
|
|
|
|
<string name="title_rename_session">Set session name</string>
|
|
<string name="action_rename_session_confirm">Set</string>
|
|
<string name="title_create_named_session">New named session</string>
|
|
<string name="action_create_named_session_confirm">Create</string>
|
|
|
|
<string name="action_toggle_soft_keyboard">Keyboard</string>
|
|
|
|
|
|
|
|
<!-- Terminal Popup -->
|
|
<string name="action_select_url">Select URL</string>
|
|
<string name="title_select_url_dialog">Click URL to copy or long press to open</string>
|
|
<string name="title_select_url_none_found">No URL found in the terminal.</string>
|
|
<string name="msg_select_url_copied_to_clipboard">URL copied to clipboard</string>
|
|
|
|
<string name="action_share_transcript">Share transcript</string>
|
|
<string name="title_share_transcript">Terminal transcript</string>
|
|
<string name="title_share_transcript_with">Send transcript to:</string>
|
|
|
|
<string name="action_autofill_password">Autofill password</string>
|
|
|
|
<string name="action_reset_terminal">Reset</string>
|
|
<string name="msg_terminal_reset">Terminal reset.</string>
|
|
|
|
<string name="action_kill_process">Kill process (%d)</string>
|
|
<string name="title_confirm_kill_process">Really kill this session?</string>
|
|
|
|
<string name="action_style_terminal">Style</string>
|
|
<string name="action_toggle_keep_screen_on">Keep screen on</string>
|
|
<string name="action_open_help">Help</string>
|
|
<string name="action_open_settings">Settings</string>
|
|
|
|
<string name="error_styling_not_installed">The &TERMUX_STYLING_APP_NAME; Plugin App is not installed.</string>
|
|
<string name="action_styling_install">Install</string>
|
|
|
|
|
|
|
|
<!-- Termux Notifications -->
|
|
<string name="notification_action_exit">Exit</string>
|
|
<string name="notification_action_wake_lock">Acquire wakelock</string>
|
|
<string name="notification_action_wake_unlock">Release wakelock</string>
|
|
|
|
|
|
|
|
<!-- Termux RunCommandService -->
|
|
<string name="error_run_command_service_invalid_intent_action">Invalid intent action to RunCommandService: `%1$s`</string>
|
|
<string name="error_run_command_service_mandatory_extra_missing">Mandatory extra missing to RunCommandService: \"%1$s\"</string>
|
|
<string name="error_run_command_service_allow_external_apps_ungranted">RunCommandService require `allow-external-apps` property to be set to `true` in `&TERMUX_PROPERTIES_PRIMARY_PATH_SHORT;` file.</string>
|
|
<string name="error_run_command_service_api_help">Visit https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/RunCommandService.java for more info on RUN_COMMAND Intent usage.</string>
|
|
|
|
|
|
|
|
<!-- Termux Execution Commands -->
|
|
<string name="msg_executable_absolute_path">Executable Absolute Path: \"%1$s\"</string>
|
|
<string name="msg_working_directory_absolute_path">Working Directory Absolute Path: \"%1$s\"</string>
|
|
<string name="error_sending_sigkill_to_process">Sending SIGKILL to process on user request or because android is killing the service</string>
|
|
<string name="error_failed_to_execute_termux_session_command">"Failed to execute \"%1$s\" termux session command"</string>
|
|
<string name="error_failed_to_execute_termux_task_command">"Failed to execute \"%1$s\" termux task command"</string>
|
|
|
|
|
|
|
|
<!-- Termux FileUtils -->
|
|
<string name="error_executable_required">Executable required.</string>
|
|
<string name="error_null_or_empty_path">The path is null or empty.</string>
|
|
<string name="error_null_or_empty_file">The file is null or empty.</string>
|
|
<string name="error_null_or_empty_executable">The executable is null or empty.</string>
|
|
<string name="error_null_or_empty_directory">The directory is null or empty.</string>
|
|
<string name="error_invalid_file_permissions_string_to_check">The file permission string to check is invalid.</string>
|
|
<string name="error_no_regular_file_found">Regular file not found at path.</string>
|
|
<string name="error_no_directory_found">Directory not found at path.</string>
|
|
<string name="error_file_not_readable">%1$s at path is not readable. Permission Denied.</string>
|
|
<string name="error_file_not_writable">%1$s at path is not writable. Permission Denied.</string>
|
|
<string name="error_file_not_executable">%1$s at path is not executable. Permission Denied.</string>
|
|
<string name="error_non_regular_file_found">Non-regular file found at path.</string>
|
|
<string name="error_non_directory_file_found">Non-directory file found at path.</string>
|
|
<string name="error_creating_missing_directory_failed">Failed to create missing directory at path: \"%1$s\"</string>
|
|
<string name="error_validate_file_existence_and_permissions_failed_with_exception">Validating file existence and permissions fafiled: \"%1$s\"\nException: %2$s</string>
|
|
<string name="error_validate_directory_existence_and_permissions_failed_with_exception">Validating directory existence and permissions fafiled: \"%1$s\"\nException: %2$s</string>
|
|
|
|
|
|
|
|
<!-- Termux Report And ShareUtils -->
|
|
<string name="action_copy">Copy</string>
|
|
<string name="action_share">Share</string>
|
|
|
|
<string name="title_share_with">Share With</string>
|
|
<string name="title_report_text">Report Text</string>
|
|
|
|
|
|
|
|
<!-- Termux PermissionUtils -->
|
|
<string name="message_sudo_please_grant_permissions">Please grant permissions on next screen</string>
|
|
<string name="error_display_over_other_apps_permission_not_granted">&TERMUX_APP_NAME; requires \"Display over other apps\" permission to start terminal sessions from background on Android >= 10. Grants it from Settings -> Apps -> &TERMUX_APP_NAME; -> Advanced</string>
|
|
|
|
|
|
|
|
<!-- Termux File Receiver -->
|
|
<string name="title_file_received">Save file in ~/downloads/</string>
|
|
<string name="action_file_received_edit">Edit</string>
|
|
<string name="action_file_received_open_directory">Open directory</string>
|
|
|
|
|
|
|
|
<!-- Termux Settings -->
|
|
<string name="title_activity_termux_settings">&TERMUX_APP_NAME; Settings</string>
|
|
|
|
<!-- Debugging Preferences -->
|
|
<string name="debugging_preferences">Debugging</string>
|
|
|
|
<!-- Logging Category -->
|
|
<string name="logging_header">Logging</string>
|
|
|
|
<!-- Log Level -->
|
|
<string name="log_level_title">Log Level</string>
|
|
<string name="log_level_off">"Off"</string>
|
|
<string name="log_level_normal">"Normal"</string>
|
|
<string name="log_level_debug">"Debug"</string>
|
|
<string name="log_level_verbose">"Verbose"</string>
|
|
<string name="log_level_unknown">"*Unknown*"</string>
|
|
<string name="log_level_value">Logcat log level set to \"%1$s\"</string>
|
|
|
|
<!-- Terminal View Key Logging -->
|
|
<string name="terminal_view_key_logging_title">Terminal View Key Logging</string>
|
|
<string name="terminal_view_key_logging_off">Logs will not have entries for terminal view keys. (Default)</string>
|
|
<string name="terminal_view_key_logging_on">Logcat logs will have entries for terminal view keys. These are very verbose and should be disabled under normal circumstances or will cause performance issues.</string>
|
|
|
|
<!-- Plugin Error Notifications -->
|
|
<string name="plugin_error_notifications_title">Plugin Error Notifications</string>
|
|
<string name="plugin_error_notifications_off">Disable flashes and notifications for plugin errors.</string>
|
|
<string name="plugin_error_notifications_on">Show flashes and notifications for plugin errors. (Default)</string>
|
|
|
|
</resources>
|