多玩家测验应用基于Salesforce技术的搭建与使用指南

多玩家测验应用基于Salesforce技术的搭建与使用指南

quiz-host-app Multiplayer quiz app built on Salesforce technology (host app) 项目地址: https://gitcode.com/gh_mirrors/qu/quiz-host-app

本指南将引导您深入了解并部署从GitHub上的Quiz Host App这一开源项目，该应用利用Salesforce技术构建了一个多人实时竞答平台。以下是关于项目的主要内容模块：项目目录结构、启动文件以及配置文件的详细介绍。

1. 项目目录结构及介绍

由于原始引用内容没有提供详细的目录结构，我将基于一般Salesforce LWC项目和标准的Heroku应用部署推测一个大致的结构。请注意，实际结构可能有所不同。

Quiz-Host-App/
├── src                                 # 主要源代码目录
│   ├── lightning                      # LWC组件存放位置
│   │   └── quiz-component              # 具体的测验组件
│   ├── apex                            # Salesforce Apex代码
│   ├── staticresources                # 静态资源（如CSS、图片）
│   └── ...                             # 其他必要目录
├── sfdx-project.json                   # Salesforce DX项目配置文件
├── package.xml                         # 包含组件清单的文件
├── heroku                              # Heroku部署相关文件或说明
│   ├── Procfile                        # Heroku应用的进程定义文件
│   ├── runtime.txt                     # 指定Node.js运行时版本
│   └── ...                             # 其他Heroku配置文件
├── README.md                           # 项目简介和快速入门指南
└── install-dev.*                       # 安装脚本，用于部署和初始化环境

2. 项目的启动文件介绍

对于Host App安装：

• install-dev.sh: 在MacOS或Linux环境下，这是一个Shell脚本，负责在Salesforce的Scratch组织中部署测验主机应用，并预加载示例问题。
• install-dev.bat: 类似地，适用于Windows环境，执行相同的应用部署过程。

对于Player App部署：

• Heroku部署按钮: 文档指出可以点击特定按钮将Player App直接部署到Heroku上，但具体文件路径未给出。此过程通常涉及Heroku CLI或通过Web界面手动设置。

3. 项目的配置文件介绍

配置变量（Config Vars）：

虽然不是传统意义上的本地配置文件，但Heroku中使用的Config Vars扮演了重要配置角色，必须为Player App设置以下变量：

• QUIZ_API_KEY: 生成的安全令牌，作为API密钥。
• SF_LOGIN_URL: Salesforce组织的登录URL。
• SF_PASSWORD, SF_SECURITY_TOKEN, SF_USERNAME: 用户凭据。
• SF_NAMESPACE: 如果开发自定义命名空间，否则保持默认。
• COLLECT_PLAYER_EMAILS: 控制是否收集玩家邮箱的布尔值。

Salesforce内的配置：

• Remote Site Settings: 添加名为“Quiz_Player_App”的新站点，其URL为Heroku部署的Player App地址。
• Custom Metadata Types: 创建记录来存储Player App的URL（原生和缩短版）、Quiz API Key等关键设置。

以上结构和步骤基于提供的上下文进行假设性描述，实际项目结构和文件名需参照仓库中的最新文件和说明。

quiz-host-app Multiplayer quiz app built on Salesforce technology (host app) 项目地址: https://gitcode.com/gh_mirrors/qu/quiz-host-app