Titanium SDK 中 Android 菜单系统深度解析

Titanium SDK 中 Android 菜单系统深度解析

概述

在 Titanium SDK 的 Android 模块中，Titanium.Android.Menu 类提供了创建和管理 Android 选项菜单的强大功能。本文将深入探讨这一核心组件，帮助开发者掌握在跨平台应用中实现原生 Android 菜单系统的技巧。

菜单基础概念

Android 菜单系统经历了多次演进，从传统的选项菜单到现代的动作栏(Action Bar)设计。Titanium SDK 的 Menu API 抽象了这些差异，让开发者能够：

1. 创建标准的选项菜单项
2. 在动作栏中显示常用操作
3. 管理菜单项的可见性和可用性状态

核心 API 详解

创建菜单项

使用 add() 方法是构建菜单的基础：

menu.add({
    title: "保存", 
    icon: "save.png",
    showAsAction: Ti.Android.SHOW_AS_ACTION_IF_ROOM
});

关键配置选项包括：

• title: 菜单项显示文本
• icon: 菜单项图标
• showAsAction: 控制是否显示在动作栏
• itemId: 唯一标识符，用于后续查找

菜单项管理

Menu 类提供了丰富的管理方法：

1. 查找菜单项：

   var item = menu.findItem(itemId);
   

2. 按索引获取：

   var firstItem = menu.getItem(0);
   

3. 批量操作：

   menu.removeGroup(groupId); // 移除整个分组
   menu.setGroupVisible(groupId, false); // 隐藏分组
   

动态菜单更新

在 Android 3.0+ 设备上，需要调用 invalidateOptionsMenu() 来刷新菜单状态：

win.activity.invalidateOptionsMenu();

实际应用场景

场景一：登录状态切换

activity.onCreateOptionsMenu = function(e) {
    var menu = e.menu;
    menu.add({
        title: loggedIn ? "登出" : "登录",
        itemId: LOGIN_ITEM,
        icon: loggedIn ? 'logout.png' : 'login.png'
    });
};

场景二：上下文敏感菜单

activity.onPrepareOptionsMenu = function(e) {
    var currentItem = getCurrentContextItem();
    var menu = e.menu;
    menu.findItem(EDIT_ITEM).visible = currentItem.editable;
};

Alloy 框架中的菜单实现

在 Alloy 中，可以通过声明式 XML 定义菜单结构：

<Menu id="mainMenu" platform="android">
    <MenuItem id="saveItem" 
              title="保存" 
              icon="save.png"
              onClick="handleSave"
              showAsAction="Ti.Android.SHOW_AS_ACTION_IF_ROOM" />
</Menu>

重要提示：Alloy 菜单需要在窗口的 open 事件中调用 invalidateOptionsMenu() 才能立即显示。

兼容性考虑

针对不同 Android 版本，菜单表现有所差异：

1. Android 3.0 之前：总是显示为传统选项菜单
2. Android 3.0+：支持动作栏集成，需使用 Holo 主题

最佳实践

1. 为常用操作设置 SHOW_AS_ACTION_ALWAYS 标志
2. 使用图标增强菜单项的可识别性
3. 合理分组相关菜单项
4. 在 onPrepareOptionsMenu 中处理动态菜单逻辑
5. 及时释放不再使用的菜单项引用

常见问题解决

问题：菜单项不显示在动作栏上
解决：检查主题设置并确认 showAsAction 属性值正确

问题：动态更新菜单无效
解决：确保调用了 invalidateOptionsMenu() 方法

问题：TabGroup 中菜单不工作
解决：通过 TabGroup 的 activity 属性访问菜单系统

通过掌握这些核心概念和技巧，开发者能够在 Titanium SDK 应用中构建出既符合 Android 设计规范又具备良好用户体验的菜单系统。