Atlassian Connect Add-On 开发指南：使用 App Engine 快速入门

资源摘要信息:"Atlassian-Connect-Add-On-Starter-Kit-for-App-Engine是一个示例项目，旨在展示如何使用Google App Engine编写Atlassian Connect Add On。该项目提供了两个应用程序示例，分别是Hello World和语言检查。Hello World是一个简单的演示，展示了如何将所有内容连接起来制作一个简单的JIRA附加组件。语言检查应用则会遍历JIRA中的问题，并标记出所有使用非默认语言编写的内容。该项目支持多种编程语言，包括PHP、Java、Python和Go，每种语言都有两个应用程序的示例。这些示例被设计为可单独运行的插件，假设它们将在本地主机的8080端口上运行。需要注意的是，这个项目并非Google的官方产品。" ### 知识点 #### 1. Atlassian Connect Add On 概念 Atlassian Connect是Atlassian公司提供的一种框架，用于构建和部署与Atlassian产品（如JIRA、Confluence等）集成的应用程序。Add On或插件可以扩展这些产品的功能，提供更丰富的工作流程和定制化体验。Atlassian Connect Add On通过Web钩子（Webhooks）、REST API、OAuth认证等机制与Atlassian产品进行交互。 #### 2. Google App Engine 平台介绍 Google App Engine（GAE）是一个由Google提供的全托管的平台即服务（PaaS），用于运行Web应用程序。App Engine提供了一套SDK和API，允许开发者通过编写应用程序来管理数据存储、用户认证和后台任务等服务。开发者可以使用App Engine支持的多种语言（包括Java、Python等）来构建和部署应用程序。 #### 3. 示例项目结构 项目包含两个核心应用程序示例，每一个都有4种语言版本：PHP、Java、Python和Go。 - **Hello World 应用程序** - 用于演示基本的Atlassian Connect Add On的连接和运行。 - 展示如何通过编写简单的代码来创建一个JIRA附加组件。 - **语言检查应用程序** - 用于演示如何通过Atlassian Connect Add On访问JIRA实例中的问题。 - 对问题进行语言检查，高亮不符合默认语言规范的文本。 #### 4. 语言特定的知识点 - **PHP** - 了解PHP语言的基础知识。 - 学习如何使用PHP编写Web应用程序和服务。 - 掌握PHP与Atlassian Connect API交互的方法。 - **Java** - 掌握Java基础，包括Java SE和Java EE。 - 理解Java Web应用程序开发流程，如使用Servlet进行请求处理。 - 学习如何通过Java集成Atlassian Connect API。 - **Python** - 掌握Python编程语言，包括Python 2和Python 3。 - 了解Web框架如Flask或Django，使用它们来构建Web服务。 - 学习如何使用Python编写与Atlassian Connect集成的代码。 - **Go** - 掌握Go语言的基本语法和特性。 - 学习Go的标准库，特别是HTTP和OAuth库。 - 实践使用Go创建RESTful API与Atlassian Connect Add On交互。 #### 5. Atlassian Connect Add On 开发要点 - **使用标准的RESTful接口**：确保应用程序可以通过标准的HTTP方法与Atlassian产品交互。 - **认证与授权**：实现OAuth认证流程，确保应用程序的安全性和授权访问用户数据。 - **Webhooks的使用**：了解如何利用Webhooks来监听和响应Atlassian产品中的事件。 - **元数据配置**：通过编写manifest.json文件来配置插件的元数据，如描述、授权范围等。 #### 6. 开发环境和本地测试 - **本地开发服务器**：了解如何在本地设置开发环境，并使用本地服务器运行应用程序。 - **端口映射**：由于假设所有插件都在本地主机的8080端口上运行，开发者需要配置端口映射以确保本地开发环境与Atlassian产品兼容。 #### 7. 部署和维护 - **云服务部署**：学习如何将应用程序部署到云服务上，如Google App Engine。 - **持续集成/持续部署（CI/CD）**：建立有效的CI/CD流程，确保代码的持续集成和部署。 #### 8. 版本控制和代码管理 - **Git使用**：掌握Git版本控制系统的使用，以便跟踪代码变更和协作开发。 - **代码库管理**：了解如何管理代码库，包括分支、合并请求和版本发布。 通过上述知识点，开发者可以充分理解和掌握如何使用Google App Engine来开发Atlassian Connect Add On，并为Atlassian产品如JIRA提供定制化的功能扩展。这个项目为开发者提供了实践的机会，以更深入地了解和应用Atlassian Connect技术栈。