AwesomeMenu 项目技术文档

1. 安装指南

环境要求

• iOS 开发环境
• Xcode 已安装
• 支持 Objective-C 的项目

安装步骤

1. 将 AwesomeMenu 项目文件添加到你的 Xcode 项目中。
2. 确保项目中包含所需的资源文件，如 bg-menuitem.png、bg-menuitem-highlighted.png、icon-star.png 等。
3. 在需要使用 AwesomeMenu 的文件中导入头文件：

   #import "AwesomeMenu.h"
   

2. 项目的使用说明

创建菜单项

首先，你需要创建菜单项。每个菜单项由图像和按下状态的图像组成。以下是一个示例：

UIImage *storyMenuItemImage = [UIImage imageNamed:@"bg-menuitem.png"];
UIImage *storyMenuItemImagePressed = [UIImage imageNamed:@"bg-menuitem-highlighted.png"];
UIImage *starImage = [UIImage imageNamed:@"icon-star.png"];
AwesomeMenuItem *starMenuItem1 = [[AwesomeMenuItem alloc] initWithImage:storyMenuItemImage
                                                       highlightedImage:storyMenuItemImagePressed
                                                           ContentImage:starImage
                                                highlightedContentImage:nil];
AwesomeMenuItem *starMenuItem2 = [[AwesomeMenuItem alloc] initWithImage:storyMenuItemImage
                                                       highlightedImage:storyMenuItemImagePressed
                                                           ContentImage:starImage
                                                highlightedContentImage:nil];

创建启动项

启动项类似于 Path 应用中的“添加”按钮。以下是一个示例：

AwesomeMenuItem *startItem = [[AwesomeMenuItem alloc] initWithImage:[UIImage imageNamed:@"bg-addbutton.png"]
                                                   highlightedImage:[UIImage imageNamed:@"bg-addbutton-highlighted.png"]
                                                       ContentImage:[UIImage imageNamed:@"icon-plus.png"]
                                            highlightedContentImage:[UIImage imageNamed:@"icon-plus-highlighted.png"]];

设置菜单

接下来，设置菜单并添加到视图中：

AwesomeMenu *menu = [[AwesomeMenu alloc] initWithFrame:self.window.bounds startItem:startItem optionMenus:@[starMenuItem1, starMenuItem2]];
menu.delegate = self;
[self.window addSubview:menu];

3. 项目API使用文档

菜单选项

你可以通过设置以下属性来自定义菜单的行为和外观：

• startPoint: 设置“添加”按钮的中心位置。

  menu.startPoint = CGPointMake(160.0, 240.0);
  

• rotateAngle: 设置旋转角度。

  menu.rotateAngle = 0.0;
  

• menuWholeAngle: 设置整个菜单的角度。

  menu.menuWholeAngle = M_PI * 2;
  

• timeOffset: 设置每个菜单项飞出动画的延迟时间。

  menu.timeOffset = 0.036f;
  

• farRadius: 设置弹跳动画的远距离半径。

  menu.farRadius = 140.0f;
  

• nearRadius: 设置弹跳动画的近距离半径。

  menu.nearRadius = 110.0f;
  

• endRadius: 设置“添加”按钮与菜单项之间的距离。

  menu.endRadius = 120.0f;
  

4. 项目安装方式

手动安装

1. 下载 AwesomeMenu 项目文件。
2. 将文件添加到你的 Xcode 项目中。
3. 确保项目中包含所需的资源文件。

CocoaPods 安装（可选）

如果你使用 CocoaPods，可以在 Podfile 中添加以下内容：

pod 'AwesomeMenu', :git => 'https://github.com/your-repo/AwesomeMenu.git'

然后运行 pod install。

通过以上步骤，你就可以成功安装并使用 AwesomeMenu 项目了。