《釘釘應用開發者速成手冊》之“釘釘應用開發入門——小程式”

步驟一：建立應用

參考以下步驟，在釘釘開放平台上建立企業内部小程式，并完成基礎配置：

1. 使用釘釘開發者賬号登入 開發者背景

   。

   說明

   隻有管理者和子管理者可登入開發者背景。

2. 在開發者背景頁面，單擊應用開發，然後選擇企業内部開發 > 小程式，最後單擊建立應用。

   

3. 在彈出的建立應用頁面中填寫基本資訊，然後單擊确定建立。

• • 應用類型：選擇小程式。
  • 開發方式：選擇企業自助開發。

1. 應用建立完成後，在憑證與基礎資訊頁面，複制應用的AppKey和AppSecret備用。

   

2. 單擊開發管理進入開發管理頁面，然後單擊修改，并根據以下内容配置開發資訊。

• • 伺服器出口IP：輸入調用釘釘服務端API時使用的IP即企業伺服器的公網IP，多個IP請以英文逗号","隔開，支援帶一個*号通配符的IP格式。最多可設定20個，并且符合IPV4規則。
  • PC端首頁位址（可選）：輸入在PC端釘釘工作台上打開本應用的位址。連結位址必須以http或https開頭。
  • 管理背景位址（可選）：輸入組織管理者在 釘釘管理背景 通路該應用的位址。

1. 單擊人員管理，然後單擊添加人員添加開發人員。

   應用建立後，預設開發人員為應用建立者。隻有在這裡添加了開發人員，開發人員才可以在小程式IDE中關聯這個應用。

   

2. 單擊安全中心，然後單擊添加添加一個HTTP安全域名。

   安全域名是後端服務部署的伺服器的公網IP或域名。當小程式的前端與服務端需要進行網絡通信時，需要設定安全域名。小程式前端隻能通過已設定的安全域名（或IP）與服務端進行網絡通信。當安全域名更新時，需要在小程式開發工具重新打包上傳版本，設定的域名才會生效。

   

3. 單擊權限管理進入權限管理頁面，然後根據以下配置添加接口調用權限。說明權限管理主要包含基礎權限、進階權限-微應用、進階權限-企業通訊錄三個部分，還包括特殊權限申請。建議開發者自助按需申請接口權限，合理設定權限的範圍。本教程中需要調用接口擷取使用者的姓名和userid，是以需要先添加通訊錄接口權限。

1. 1. 權限範圍選擇全部員工，然後單擊添加接口權限。
   2. 選擇通訊錄 > 通訊錄隻讀權限，單擊确認。

步驟二：服務端開發

建立應用成功後，參考以下步驟完成服務端代碼的配置部署：

1. 下載下傳服務端代碼。

git clone https://github.com/open-dingtalk/org-mini-program-tutorial-java.git      

1. 導入服務端代碼。

1. 1. 運作IntelliJ IDEA，然後在啟動頁面單擊Open。

      

   2. 将下載下傳好的服務端代碼導入到項目工程。

      

   3. 單擊OK，完成服務端的部署。

1. 配置服務端代碼。修改

   src/main/java/com/dingtalk/constant/AppConstant.java

   檔案中參數值。

   

• • AppKey：應用的唯一身份辨別，填寫建立應用時複制的AppKey。
  • AppSecret：對應的調用密鑰，填寫建立應用時複制的AppSecret。

1. 啟動後端服務。

   打開

   src/main/java/com/dingtalk/Application.java

   檔案，運作後端服務。

   

2. 在浏覽器中通路 http://localhost:8080/welcome

   檢查服務是否啟動成功。

   顯示如下頁面表示啟動成功。

   

步驟三：前端開發

服務端代碼配置部署成功後，參考以下步驟完成小程式前端代碼的配置部署：

1. 下載下傳前端代碼。

git clone https://github.com/open-dingtalk/org-mini-program-tutorial-front-end.git      

1. 導入前端代碼。

   小程式IDE工具，然後選擇已下載下傳的小程式項目，項目類型選擇釘釘 > 企業内部應用，點選完成。

   

2. 登陸IDE工具。

   打開釘釘APP，掃碼頁面上的二維碼。

   

3. 關聯已建立的小程式應用小程式Demo。

   如果無法關聯小程式，登入

   ，檢查開發人員是否已添加到應用的人員管理清單。

   

4. 配置前端代碼。打開

   org-mini-program-tutorial-front-end/page/index/index.js

   檔案修改配置資訊。注意URL中的IP或者域名必須是開發者背景台中設定的本應用的安全域名。

   

• • domain：開發者背景設定的安全域名。
  • url：服務端接口通路路徑。

1. 單擊點選登入調試小程式，檢視是否可以成功擷取登入資訊。

   

步驟四：上傳釋出小程式

前端代碼配置部署成功後，參考以下步驟完成上傳和釋出小程式：

1. 單擊上傳，确認小程式版本，然後再次單擊上傳。

   

2. 上傳成功後，打開 ，在應用詳情頁面，單擊版本管理與釋出，然後選擇已上傳的版本，再單擊釋出。

   

3. 預設釋出後企業内部成員可使用該版本的應用。您可以選擇使用該應用的使用者範圍，然後單擊儲存修改。