2016-03-01 98 views
0

我對Android開發很新穎。最近,我注意到有很多START和在谷歌自己的示例代碼周邊功能模塊END意見,for exampleAndroid示例代碼中的START和END註釋是什麼?

// [START configure_signin] 
    // Configure sign-in to request the user's ID, email address, and basic 
    // profile. ID and basic profile are included in DEFAULT_SIGN_IN. 
    GoogleSignInOptions gso = 
     new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN) 
      .requestEmail() 
      .build(); 
    // [END configure_signin] 

我從來沒有見過在其他代碼庫評論這個特殊的風格,我的工作,並我找不到任何提及其在Android代碼中使用的文檔或樣式指南。

它們是否有任何功能性用途(例如它們是否供某些測試或文檔框架使用),還是純粹是爲了讀者的利益?

+1

它可能會自動將代碼片斷出於文檔目的。他們可能在他們的文檔文件中有一個宏,上面寫着「從SigninActivity.java'插入'configure_signin'代碼。我考慮去[我的書](https://commonsware.com/Android)的代碼示例的路線。爲了避免讓開發人員看到完整的源代碼文件,我選擇不這樣做。然而,這些評論並不是正常的Android應用程序開發的一部分,不管Google爲什麼要這樣做。 – CommonsWare

回答

0

這些只是爲了澄清發生了什麼。把它們想象成標誌,讓你知道你的程序在哪裏。

相關問題