{"id":19411519,"url":"https://github.com/volcengine/ve-tls-android-sdk","last_synced_at":"2026-01-26T08:11:18.133Z","repository":{"id":173795915,"uuid":"651013552","full_name":"volcengine/ve-tls-android-sdk","owner":"volcengine","description":"TLS android sdk repository","archived":false,"fork":false,"pushed_at":"2026-01-15T09:35:58.000Z","size":355,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-18T07:37:16.274Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/volcengine.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-06-08T09:50:40.000Z","updated_at":"2025-08-28T03:18:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"e260edf7-fe12-4541-8391-8c3fee82abc2","html_url":"https://github.com/volcengine/ve-tls-android-sdk","commit_stats":null,"previous_names":["volcengine/ve-tls-android-sdk"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/volcengine/ve-tls-android-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tls-android-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tls-android-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tls-android-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tls-android-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/volcengine","download_url":"https://codeload.github.com/volcengine/ve-tls-android-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tls-android-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28770233,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T07:45:00.504Z","status":"ssl_error","status_checked_at":"2026-01-26T07:45:00.070Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T12:21:50.655Z","updated_at":"2026-01-26T08:11:18.119Z","avatar_url":"https://github.com/volcengine.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\u003cimg src=\"https://iam.volccdn.com/obj/volcengine-public/pic/volcengine-icon.png\"\u003e\u003c/h1\u003e\n\u003ch1 align=\"center\"\u003e火山引擎Android SDK for TLS\u003c/h1\u003e\n欢迎使用火山引擎SDK for Android，本文档为您介绍如何获取及调用SDK。\n\n## 前置准备\n\n### 服务开通\n\n请确保您已开通了日志服务。您可前往[火山引擎控制台](https://console.volcengine.com/ )，在左侧菜单中选择或在顶部搜索栏中搜索日志服务，进入服务控制台内完成开通流程。\n\n### 获取安全凭证\n\nAccess Key（访问密钥）是访问火山引擎服务的安全凭证，包含Access Key ID（简称为AK）和Secret Access\nKey（简称为SK）两部分。您可登录[火山引擎控制台](https://console.volcengine.com/ )，前往“[访问控制](https://console.volcengine.com/iam )\n”的“[访问密钥](https://console.volcengine.com/iam/keymanage/ )”中创建及管理您的Access\nKey。更多信息可参考[访问密钥帮助文档](https://www.volcengine.com/docs/6291/65568 )。\n\n## 获取与安装\n\n推荐通过Gradle依赖使用火山引擎SDK for TLS\n\n[![maven](https://img.shields.io/maven-central/v/com.volcengine/volc-tls-android-sdk)](https://search.maven.org/artifact/com.volcengine/volc-tls-android-sdk)\n\n\n\n\n## 相关配置\n1. 创建安卓项目。\n2. Gradle配置mavenCentral()，并引入SDK。\n```xml\n   implementation 'com.volcengine:volc-tls-android-sdk:1.1.5'\n```\n如果有依赖冲突，请使用指定你需要的版本（以okhttp为例子）\n```xml\n      implementation('com.squareup.okhttp3:okhttp') {\n        version {\n        strictly(\"you version\")\n        }\n      }\n```\n3. Android权限\n```xml\n   \u003cuses-permission android:name=\"android.permission.INTERNET\" /\u003e\n```\n\n4. 混淆配置\n```xml\n   -keep class net.jpountz.** { *; }\n```\n\n### SDK使用方法\n**方式一**：使用client用于创建project、topic等资源，方法为同步阻塞\u003cbr\u003e\n[**更多Demo参考**](https://github.com/volcengine/ve-tls-android-sdk/tree/master/src/main/java/com/volcengine/demo)\n\n```java\n// 初始化client\nClientConfig clientConfig = new ClientConfig(endPoint, region, accessKey, secretKey, token);\nTLSLogClient client = ClientBuilder.newClient(clientConfig);\n// 创建日志项目和主题\nCreateProjectRequest project = new CreateProjectRequest(projectName, region, description);\nCreateProjectResponse createProjectResponse = client.createProject(project);\n// 创建日志主题\nCreateTopicRequest createTopicRequest = new CreateTopicRequest();\ncreateTopicRequest.setTopicName(topicName);\ncreateTopicRequest.setProjectId(createProjectResponse.getProjectId());\ncreateTopicRequest.setTtl(500);\nCreateTopicResponse createTopicResponse = client.createTopic(createTopicRequest);\n// 写入日志\nList\u003cLogItem\u003e logs = new ArrayList\u003c\u003e();\ncurrentTimeMillis = System.currentTimeMillis();\nLogItem item = new LogItem(currentTimeMillis);\nitem.addContent(\"index-\", \"\" + 0);\nitem.addContent(\"test-key\", \"test-value\");\nlogs.add(item);\nPutLogsRequestV2 putLogsRequestV2 = new PutLogsRequestV2(logs, topicId, null, LZ4, \"test-path\", \"test-file\");\nPutLogsResponse putLogsResponse = client.putLogsV2(putLogsRequestV2);\n```\n**方式二**：使用producer写入日志，支持异步非阻塞\u003cbr\u003eproducer更多[**配置参考**](https://github.com/volcengine/ve-tls-android-sdk/blob/master/src/main/java/com/volcengine/model/tls/producer/Producer.md)\n```java\n// 初始化producer\nProducer producer = ProducerImpl.defaultProducer(\n       clientConfig.getEndpoint(), clientConfig.getRegion(), clientConfig.getAccessKeyId(), clientConfig.getAccessKeySecret(),\n       clientConfig.getSecurityToken());\nproducer.start();\n// 如果不需要回调，callback参数传null即可\nCallBack callBack = new CallBack() {\n   @Override\n   public void onComplete(Result result) {\n        System.out.println(\"producer result:\" + result);\n   }\n};\nLogItem item = new LogItem(System.currentTimeMillis());\nitem.addContent(\"test-key\", \"test-value\");\nproducer.sendLogV2(\"\", topicId, \"test-source\", \"test-file\", item, callBack);\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Fve-tls-android-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvolcengine%2Fve-tls-android-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Fve-tls-android-sdk/lists"}