2013年2月22日

Widget 2.0 发布啦！砰！

它来了！我们从头重写了 Corona 的 widget 库，现在可以在 每日构建 1034 中使用。

重要提示： 请参考每个每日构建附带的更新文档。一些内容已更改或已重命名，因此您应仔细研究。为了帮助您，我们还提供了一份迁移指南，该指南也与适用每日构建中的文档捆绑在一起。

（附注：1034 的每日构建 API 文档有点小问题。现在已修复！）

功能和改进

我们做的最重要的事情是决定从头开始，这对于构建一个稳定、坚实的基础至关重要。因此，Widget 2.0 将更容易扩展，也更易于维护。（关于 1.0 代码的弊端以及一个惊喜，稍后会介绍。）

主要的更改之一是集成了图像表单的概念。旧的 widget 库没有完全采用图像表单，因此为了创建主题，您必须拥有大量的单个图像文件。这太混乱了！

有了新的 widget 库，我们完全采用了图像表单。现在，widget 主题使用 imageSheets 构建，以节省纹理内存和磁盘空间。

此外，我们决定发布一个 iOS 主题和一个 Android 主题。这意味着您不再需要将额外的 widget 资源文件复制到您的项目中。我们一直觉得这有点笨拙，尤其是在您意识到 widget 框架在没有这些图像资源的情况下是不完整的。现在，当您为 iOS 构建时，我们会预先烘焙 iOS 图像资源。对于 Android 也是如此。

我们还添加了大量其他功能。以下是一些示例，让您了解我们为此付出了多少心血

• 能够创建 9 切片 widget 按钮。
• 现在可以创建垂直滑块，以及之前的水平滑块。
• 现在可以通过新的 “labelAlign” 属性将 widget 按钮的标签对齐到三个常量之一。
• 大幅改进的 widget 文档。
• 统一了整个 API 命名约定。
• 能够以图形方式设置选项卡栏的主题，（之前仅支持渐变）。
• 内置禁用 widget 按钮接收触摸事件的功能，这对于登录屏幕等非常有用。
• 内置将 widget 按钮插入 scrollView 的功能。

已修复的错误

widget 的代码重新架构使我们能够解决大量错误

• 18143：Corona 文档反馈 - 添加视觉效果，尤其是针对 widget 和 UI 项。
• 18217：widget.newTableView 类别滚动不会随着行滚动到表单顶部。
• 18496：缺少用于开关等的 widget 文档。
• 18503：widget.newProgressView 没有正确的 referencePoint。
• 18505：widget.newProgressView 默认值无法达到或测量。
• 18528：文档中缺少分段控件。
• 18537：widget.newStepper() 参考点不正确。
• 18538：widget.newStepper() 创建后移动的行为异常。
• 18975：scrollView widget 内的 widget.newButton 事件发生故障。
• 19004, 19030：widget.newTableView() – hideBackground 描述不正确。
• 20003：如果 onRelease 方法删除开关，则开/关开关 widget 在双击时失败。
• 20341：widget.newSpinner() imageSheet 文档不正确。
• 20462：widget.newTableView() 文档引用已弃用的 API。
• 20601：widget.newProgressView() 没有文档。
• 16094：widget.tableView:scrollToY / scrollToIndex 等不考虑 topPadding
• 12749：widget.newSlider 在视觉上旋转，但在功能上忽略旋转（我们添加了创建垂直滑块的功能）。
• 19031：按钮 Widget 错误。
• 18720：bottomPadding 在 scrollview widget 上不起作用。
• 20583：ScrollView 中按钮的 onEvent 不触发 “release” 和 “moved” 事件。
• 20468：ScrollView 内的对象中未发生 Moved 事件阶段。
• 18750：模拟器中的 ScrollView 超出范围。
• 15112：widget.newTableView 显示在另一个 widget.newTableView 之上，两者都在获取触摸事件*。
• 15857：TableView 行滚动不流畅/在边界上“抖动”。
• 18457：在新的 CoronaSDK.2012.942 上，TableView 函数 scrollToIndex 出现问题。
• 18778：功能请求：tableview widget 中的滚动事件。
• 19570：widget.tabbar 按钮自动间距添加了不必要的填充。
• 18886：滑块 widget 不返回事件阶段。

从 widget 1.0 迁移

现在，如果您要从 widget 1.0 迁移，您需要注意我们所做的 API 更改。

在最新的每日构建文档中，widget 库索引的顶部有一个迁移指南链接，告诉您如何更新代码以充分利用 widget 2.0。

简而言之，您应该注意以下 API

• widget.newButton()
• widget.newPickerWheel()
• widget.newScrollView()
• widget.newTabBar()
• widget.newTableView()

在迁移指南中，我们向您展示了代码在之前和之后的样子并排示例，以便您的过渡尽可能轻松。

已知问题

当然，没有哪个版本是完美的。以下是我们已经在研究的问题

• TableView 类别目前不会在屏幕上相互推入/推出。
• TableView/ScrollView 缺少滚动条。
• 单选按钮分组。
• 将选项卡栏添加到默认 widget 主题。
• 由于与状态栏高度相关的错误计算，WidgetDemo 在基于 Android 的设备上看起来不太正确。

还有一件事…

我们意识到你们中的一些人可能即将发布产品，或者无法处理各种 widget 2.0 API 更改。因此，我们今天开源了 Widget 1.0 代码！

Corona Widget 1.0 源代码现在可以在 GitHub 上找到。

这使您可以使用旧的 widget 库（即使我们认为您最好使用 Widget 2.0）。只需从 GitHub 下载 “widget-v1.lua” 并将以下行放在每个使用 widget 的 Lua 文件的顶部

local widget = require "widget-v1"

说实话，我们看着 Widget 1.0 代码，感到很尴尬 – 我们甚至讨论过是否应该将此代码发布给您。但是，我认为将此代码交给您非常重要，原因正是我在上面提到的 – 为了最大程度地减少那些试图发布应用程序的人员的中断。

现在，话虽如此，我也必须安抚我们工程团队的自豪感。因此，如果您访问 GitHub，您会在 “Readme” 文件中看到以下免责声明

我们应该警告您，此代码非常像意大利面。它不干净，而且难以维护。对于任何崭露头角的框架编写者来说，这确实是一种反模式。当您阅读此代码时，您应该立即明白为什么我们如此努力地维护旧的 widget 代码，以及为什么我们最终决定重写 widget 库。

正如我昨天提到的那样，我们一直在做很多事情。这只是我们向您发布的众多 “2.0” 项目中的第一个！