diff --git a/.gitignore b/.gitignore index 57fb4588..f2d09000 100644 --- a/.gitignore +++ b/.gitignore @@ -108,4 +108,6 @@ dist docs/ -.DS_Store \ No newline at end of file +.DS_Store + +.idea diff --git a/vscode.d.ts b/vscode.d.ts index 5c1063e1..c5390225 100644 --- a/vscode.d.ts +++ b/vscode.d.ts @@ -13784,22 +13784,20 @@ export interface AuthenticationProvider { /** - * Namespace for authentication. + * 用于校验身份的命名空间 * @maintainer {@link https://github.com/cxk0831 @cxk0831} */ export namespace authentication { /** - * Get an authentication session matching the desired scopes. Rejects if a provider with providerId is not - * registered, or if the user does not consent to sharing authentication information with - * the extension. If there are multiple sessions with the same scopes, the user will be shown a - * quickpick to select which account they would like to use. + * 得到一个与所需范围相匹配,且已认证的 session。 + * 如果插件开发者提供的 providerId 没有注册,或者用户不同意与此插件共享身份认证信息,则调用失败。 + * 如果有多个具有相同作用域的 session,则会向用户提供选择入口,让用户选择他们想要使用的账号。 * - * Currently, there are only two authentication providers that are contributed from built in extensions - * to the editor that implement GitHub and Microsoft authentication: their providerId's are 'github' and 'microsoft'. - * @param providerId The id of the provider to use - * @param scopes A list of scopes representing the permissions requested. These are dependent on the authentication provider - * @param options The {@link GetSessionOptions} to use - * @returns A thenable that resolves to an authentication session + * 目前,只有两个已认证身份,它们是由实现 Github 认证插件和 Microsoft 认证插件的开发者贡献的:providerId 是 'github' 和 'microsoft' + * @param providerId 要使用的开发者 id + * @param scopes 代表所请求权限的范围列表。它们由 providerId 决定 + * @param options 需要使用 {@link GetSessionOptions} + * @returns 返回 thenable,解析为已认证身份的 session */ export function getSession(providerId: string, scopes: readonly string[], options: AuthenticationGetSessionOptions & { createIfNone: true }): Thenable;