Titanium SDK 中 Android 应用资源访问详解

最新推荐文章于 2025-06-20 09:48:00 发布

娄妃元Kacey

最新推荐文章于 2025-06-20 09:48:00 发布

阅读量281

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00806/article/details/148782512

Titanium SDK 中 Android 应用资源访问详解

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk

概述

在 Titanium SDK 开发中，Titanium.App.Android 模块提供了访问 Android 应用资源的关键功能。这个模块是专门为 Android 平台设计的，允许开发者直接与 Android 原生应用资源进行交互。本文将深入解析该模块的核心功能和使用方法。

核心功能

1. R 命名空间资源访问

Titanium.App.Android.R 属性是访问 Android 应用资源的核心接口，它映射到 Android 原生开发中的 R 类。通过这个属性，开发者可以访问项目中定义的各种资源。

典型使用场景：

访问图片资源
获取字符串资源
引用布局文件
使用自定义资源

示例代码：

// 访问项目中的图片资源
var appIcon = Titanium.App.Android.R.drawable.app_icon;

// 获取字符串资源
var appName = Titanium.App.Android.R.string.app_name;

重要区别：

Titanium.App.Android.R 访问的是应用自身的资源
Titanium.Android.R 访问的是系统资源

2. 应用版本信息

Titanium.App.Android 提供了两个只读属性来获取应用版本信息：

appVersionCode (Number): 应用的版本号，通常用于内部版本控制
appVersionName (String): 面向用户的版本名称

这些属性从 AndroidManifest.xml 文件中读取，对于应用更新检查和版本展示非常有用。

3. 启动 Intent 管理

launchIntent 属性返回用于启动应用的 Intent 对象。这个属性在以下场景中特别有用：

重新启动应用
从后台恢复应用
处理应用启动逻辑

注意事项：

此 Intent 在应用生命周期内不会改变
对于处理数据 Intent（如 URL 启动），应使用 Ti.Android.rootActivity.intent

事件处理

快捷方式点击事件

从 7.5.0 版本开始，shortcutitemclick 事件允许开发者处理应用快捷方式的点击操作。

事件属性：

id: 被点击的快捷方式的标识符

典型应用场景：

动态快捷方式处理
深度链接导航
应用快捷功能入口

实战示例

自定义字符串资源使用

创建资源文件：在项目目录的 platform/android/res/values/ 下创建 mystrings.xml 文件：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="welcome_message">欢迎使用我们的应用</string>
    <string name="app_description">这是一个使用Titanium开发的跨平台应用</string>
</resources>

在JavaScript中访问：

// 获取当前Activity
var activity = Ti.Android.currentActivity;

// 获取资源引用
var R = Ti.App.Android.R;

// 获取字符串资源
var welcomeMsg = activity.getString(R.string.welcome_message);
var appDesc = activity.getString(R.string.app_description);

// 使用资源
var label = Ti.UI.createLabel({
    text: welcomeMsg + '\n' + appDesc,
    textAlign: 'center'
});

// 添加到窗口
var win = Ti.UI.createWindow();
win.add(label);
win.open();