企業級智慧編碼方案,完成工作更高效!完成線上部署並上傳部署驗證截圖兩個任務,可獲得新年好運日曆1個,每個工作日限量30個,數量有限,先到先得。(文末點選閱讀原文參與活動)。
一、引言
本方案提出以通義靈碼為核心的智慧開發流程。通義靈碼在程式碼生成、註釋新增及單元測試方面實現快速生成,雲效則作為程式碼管理和持續整合平臺,最終將應用程式部署到函式計算 FC 平臺。
適用客戶:
-
需要提高程式碼編寫效率並保持高質量輸出的軟體開發團隊。
-
尋求透過智慧化工具簡化開發流程並加快產品迭代速度的技術團隊。
本次活動旨在幫助使用者透過實際操作,使用企業級智慧編碼方案,完成工作更高效,使通義靈碼與雲效協同提升效能,並有機會贏取豐厚獎品。
二、方案概覽
本方案透過將通義靈碼服務整合到本地IDE中,為開發者提供智慧化的編碼輔助功能,包括程式碼解釋、自然語言生成程式碼、註釋生成、單元測試生成等。結合雲效進行程式碼版本管理、程式碼檢測和單元測試,開發者不僅能夠高效協作和交付專案,還可以透過雲效將專案程式碼部署到函式計算 FC,提升開發效率,減少人為錯誤,加速專案交付,為開發者提供無縫的編碼、管理和部署體驗。
三、線上部署
如果您還沒有阿里雲賬號,請訪問阿里雲賬號註冊頁面,根據頁面提示完成註冊。阿里雲賬號是您使用雲資源的付費實體,因此是部署方案的必要前提。
1. 程式碼管理與自動檢測
當前專案是一個提供演算法題實現的線上網頁,其中包括了兩道具體的演算法題目:“陣列交集提取”以及“計算日期間隔”。“陣列交集提取”程式碼已經完全實現,而“計算日期間隔”則僅僅完成了前端頁面的設計,其後端處理邏輯還有待開發。
透過將程式碼匯入雲效平臺,能夠實現程式碼的集中管理和版本控制。結合雲效的流水線功能,可以構建自動化的持續整合與持續交付(CI/CD)流程,程式碼檢測作為流水線的一部分,能夠快速識別程式碼中的潛在問題,提升程式碼質量。
1.1 程式碼匯入雲效
1. 登入雲效控制檯,根據頁面指引完成企業的建立,並選擇合適的角色。點選開始工作按鈕,即可進入雲效控制檯介面。

2. 單擊程式碼管理,進入程式碼庫。

3. 單擊匯入程式碼庫。

-
在匯入程式碼庫彈出框,選中URL匯入,在原始碼倉庫地址填入https://atomgit.com/aliyun_solution/lingma-demo.git,單擊確定。

4. 點選右上角的克隆/下載,複製倉庫地址,在本地使用git clone <倉庫地址>命令克隆倉庫。

【說明:首次克隆前請先配置 SSH 公鑰,參見配置 SSH 金鑰。】
5. 開通物件儲存服務。開啟OSS開通頁面,按照介面指引完成開通操作。
1.2 程式碼檢測雲效
1. 點選當前程式碼倉庫左側導航欄中的流水線。

2. 進入流水線頁面後,點選建立流水線。

【說明:從程式碼倉庫進入建立流水線可以自動開啟程式碼源觸發。】
3. 在彈出面板中選擇Java,頂部選擇視覺化編排,找到Java 測試、構建流水線模板,單擊建立,進入流水線配置介面。

4. 進入流水線後,在左側選擇新增流水線源。
單擊新增流水線源。
選擇流水線源為程式碼源,選擇Codeup。
程式碼倉庫選擇“lingma-demo”,預設分支選擇“main”。

5. 單擊流水線頁面右上角儲存並執行,在彈出的執行配置彈窗中單擊執行。

6. 流水線執行結果如圖所示,可以發現當前專案可以順利完成構建,但是程式碼存在某些缺陷或漏洞,並且專案缺失單元測試用例。

7. 點選Java 程式碼掃描的掃描報告,點選彈窗右下角的繼續開啟,報告中可以看到當前程式碼存在的具體問題。

2.智慧編碼
為進一步提升開發效率和程式碼質量,可以利用通義靈碼對現有程式碼進行深入解析,並在此基礎上生成新的程式碼片段和註釋。特別是針對“計算日期間隔”這一尚未完成的功能,通義靈碼將幫助我們快速實現後端處理邏輯。此外,通義靈碼還可以自動生成單元測試用例,確保程式碼的正確性和可靠性。
2.1 Visual Studio Code 中安裝通義靈碼
請按照以下步驟完成通義靈碼的安裝。
本安裝步驟適用於 macOS、Windows 或 Linux 的 Visual Studio Code 中安裝通義靈碼。
準備工作:
-
作業系統:Windows 7 及以上、macOS、Linux; -
下載並安裝Visual Studio Code1.68.0 及以上版本。
方法 1:從外掛市場安裝
【說明單擊立即安裝,喚起 Visual Studio Code 外掛市場直接安裝,安裝後請重啟 IDE,即可開啟智慧編碼之旅。】
-
開啟 Visual Studio Code 擴充套件視窗,搜尋 TONGYI Lingma,找到通義靈碼後單擊安裝。 -
安裝完成後,請重啟 Visual Studio Code。

方法 2:下載安裝包安裝
2. 下載完安裝包後,開啟 Visual Studio Code 後,單擊擴充套件,單擊更多按鈕,在下拉選單中單擊從 VSIX 安裝,選擇下載的 VSIX 檔案後安裝;

3. 安裝完成後,請重啟 Visual Studio Code。
登入並開啟智慧編碼之旅:
1. 重啟 Visual Studio Code 後,單擊側邊導航的通義靈碼,在通義靈碼助手的視窗單擊登入按鈕。

Tips:如果安裝後在側邊導航上找不到通義靈碼入口,可滑鼠聚焦在側邊導航後右鍵檢視,勾選通義靈碼後即可將外掛入口配置在側邊導航上。

2. 單擊登入後,將前往登入頁面,完成登入後可進入 IDE 客戶端開始使用。
2.2 解釋程式碼
目錄中找到實現最大公約數遍歷演算法的程式碼位於 IndexController.java 中的 common_elements 函式。當前的演算法較為複雜,我們可以利用通義靈碼來解釋和幫助理解這一演算法的實現過程。
2. 選中common_elements函式的程式碼,右擊選擇通義靈碼 > 解釋程式碼。

3. 可以看到在對話方塊中,通義靈碼給出了詳細的程式碼解釋,並提供了控制流圖。


2.3 生成程式碼註釋
1. 在common_elements函式定義的開頭,點選通義靈碼的小圖示。

2. 在下拉選項中選擇生成註釋,在對話方塊中會生成這個函式對應的註釋。

3. 在對話方塊中點選複製按鈕,複製註釋後的程式碼,貼上覆蓋原始碼

2.4 修復缺陷
1. 參考之前程式碼掃描報告中的問題,把問題複製到對話方塊中,並且選中存在問題的這部分程式碼,由通義靈碼給出修復建議。

2. 複製修復後的程式碼覆蓋原始碼。
3. 參考上述步驟,逐一修復程式碼掃描中的問題
2.5 自然語言生成程式碼
1. 在src/main/resources/templates/date.html中,找到並複製“計算日期間隔”的題目描述。

2. 在 IndexController.java中,選中dateInterval函式,將題目描述複製到問答助手對話方塊,按回車鍵確認。
3. 將生成的程式碼複製到原文中,注意不要漏掉需要引入的依賴。

4. 儲存修改後的IndexController.java檔案。
2.6 生成單元測試
1. 在common_elements函式(圖中函式名最佳化為findCommonElements)定義的開頭,點選通義靈碼的小圖示。

2. 在下拉選項中選擇單元測試,在對話方塊中會生成這個函式對應的單元測試。
目錄中找到IndexControllerTest.java,將生成的單元測試程式碼複製到檔案中。

4. 修改完畢後,儲存IndexControllerTest檔案,並在命令列中使用Git命令將程式碼提交到雲效程式碼倉庫。
git add .
git commit -m "通義靈碼最佳化"
git push
3.編碼驗證
3.1 配置流水線測試程式碼,驗證缺陷修復
1. 進入流水線Flow,可以發現當我們提交程式碼到倉庫後,之前建立的流水線觸發自動執行。

2. 點選流水線名稱,進入詳情頁。
3. 流水線執行完畢後,可以看到當前的Java 程式碼掃描漏洞數量為0。

3.2 檢視單元測試報告,驗證生成的單元測試程式碼準確無誤
1. 可以看到當前單元測試透過率為100%,所有的測試用例均成功執行。

2. 可以點選測試報告,進一步檢視測試用例的具體執行情況。

4.部署應用
專案雖然完成了構建,但沒有進行部署,我們可以配置以下的雲資源並部署應用。
4.1 函式計算配置執行環境
1. 開通函式計算:根據頁面提示單擊領取試用套餐並開通,然後單擊立即購買即可自動開通服務。

2. 點選模板連結,開啟我們提供的函式計算應用模板,選擇直接部署,其餘配置項可以不做修改,點選建立並部署預設環境。

4.2 配置流水線部署應用
1. 進入流水線Flow,單擊目標流水線,進入詳情頁。
2. 點選右上角編輯按鈕。

3. 點選Java構建上傳,在彈窗中找到構建物上傳,修改打包路徑為“.”。修改完畢後點右上角關閉編輯頁面。

4. 流水線流程配置:
-
單擊新的任務。

-
點選部署,選擇部署到函式計算FC。

-
點選部署到函式計算FC。

-
在彈出的編輯頁面找到任務步驟 ,點選執行命令。

-
點選環境變數的新增按鈕 ,選擇上游任務 製品/映象 下載地址。

-
環境變數名稱設定為code,將其值指定為上游構建階段生成的產物,如製品名稱.Artifacts_xxx。

-
配置阿里函式計算部署。
-
單擊新增服務連線。在新建服務連接面板單擊建立,完成RAM授權後,建立服務連線。

-
地域選擇華東1(杭州),服務名選擇“lingma-service”,函式名選擇“lingma-demo”,原始碼型別選擇原生代碼,程式碼路徑輸入“.”。

5. 單擊流水線頁面右上角儲存並執行,在彈出的執行配置彈窗中單擊執行。

6. 如圖所示,可以看到流水線已經執行成功,實現部署到函式計算FC。

4.3 訪問測試域名
1. 開啟函式計算應用列表,找到之前建立的應用,點選應用名稱進入應用詳情。

2. 在環境資訊中找到訪問域名,點選域名。

【說明:該域名是 CNCF SandBox 專案 Serverless Devs 社群所提供,僅供學習和測試使用,不可用於任何生產使用,域名會在30天后由社群回收。】
5.部署驗證
驗證通義靈碼生成程式碼的有效性
1. 在瀏覽器中訪問測試域名,看到如圖所示的頁面表示服務已經正常啟動。

2. 在當前頁面按照提示輸入數字並提交後,檢視結果,結合之前通義靈碼提供的程式碼解釋,可以更好地理解這道演算法題的實現過程。

3. 點選導航欄中的“計算日期間隔”,在輸入框中選擇兩個日期並點選提交。

4. 可以看到正確計算出了兩個日期的間隔時間,說明使用通義靈碼生成的程式碼正確有效。

6. 清理資源
1. 手動刪除函式計算應用:登入函式計算控制檯,在左側導航欄,單擊應用。找到目標應用,單擊右側操作列的刪除應用。

2. 刪除雲效的流水線:進入雲效流水線,點選流水線右側

->刪除。

3. 刪除程式碼倉庫。
進入雲效程式碼管理,點選目的碼倉庫名稱進入倉庫詳情頁。
點選左下角的設定->基本設定-> 刪除程式碼庫。

四、AI編碼,十倍提速,通義靈碼引領研發新正規化
想必你透過閱讀,已經學會如何部署了。現在邀請你來到阿里雲開發者社群參加“AI編碼,十倍提速,通義靈碼引領研發新正規化”活動,跟隨教程完成任務一和任務二即可領取新年好運日曆,每個工作日限量30個,上午10點更新獎品,領完即止。完成任務後需點選“領取獎品”按鈕,前往社群“積分商城”中的“活動禮品兌換專區”,使用賬戶中的1積分進行兌換,有效期為15天。

點選閱讀原文,體驗十倍提速的AI編碼~