Skip to content

Commit e3e1471

Browse files
committed
change readme
1 parent 71546ce commit e3e1471

File tree

2 files changed

+10
-222
lines changed

2 files changed

+10
-222
lines changed

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,11 @@
11
**2017-03-08**
22

3+
最新版本v7.2.15,适用于.NET Framework 2.0+
4+
5+
* * *
6+
7+
**2017-03-08**
8+
39
最新版本v7.2.15,适用于.NET Framework 2.0+ , .NET Core 和 UWP
410

511
修复:时间戳防盗链(位于`Qiniu.CDN.Model`)函数中的一个已知问题

README.md

Lines changed: 4 additions & 222 deletions
Original file line numberDiff line numberDiff line change
@@ -1,102 +1,10 @@
11
# Qiniu (Cloud) C# SDK
22

3-
[![Documentation](https://img.shields.io/badge/Qiniu%20C%23%20SDK-Documentation-brightgreen.svg)](https://developer.qiniu.com/kodo/sdk/csharp) [![Supported](https://img.shields.io/badge/Supported-.NET2.0%2B%2F.NETCore%2FUWP-brightgreen.svg)](#)
3+
## 使用
44

5-
[![GitHub release](https://img.shields.io/github/release/qiniu/csharp-sdk.svg?label=github)](https://github.com/qiniu/csharp-sdk/releases) [![Github Downloads](https://img.shields.io/github/downloads/qiniu/csharp-sdk/total.svg?colorB=aaaaff)](https://github.com/qiniu/csharp-sdk/releases) [![NuGet release](https://img.shields.io/nuget/v/Qiniu.Shared.svg?colorB=aa77ff)](https://www.nuget.org/packages/Qiniu.Shared) [![Travis](https://img.shields.io/travis/qiniu/csharp-sdk.svg)](https://travis-ci.org/qiniu/csharp-sdk) [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/qiniu/csharp-sdk/master/LICENSE)
5+
* 参考文档:[七牛云存储 C# SDK 使用指南](https://developer.qiniu.com/kodo/sdk/4055/csharp-sdk)
6+
* 可以参考我们为大家精心准备的使用 [实例](https://github.com/qiniu/csharp-sdk/tree/master/src/QiniuTests)
67

7-
## 关于
8-
9-
此 C# SDK 适用于.NET Framework 2.0+ , .NET Core 以及UWP(Windows 10 通用应用),基于七牛云API参考手册构建。使用此 SDK 构建您的网络应用程序,能让您以非常便捷地方式将数据安全地存储到七牛云存储上。无论您的网络应用是一个网站程序,还是包括从云端(服务端程序)到终端(手持设备应用)的架构的服务或应用,通过七牛云存储及其 SDK,都能让您应用程序的终端用户高速上传和下载,同时也让您的服务端更加轻盈。
10-
11-
## SDK文档
12-
13-
以下文档用于检索SDK接口、属性说明,它将有助于您理解SDK的结构。
14-
15-
* [HTML在线浏览](http://oiy037d6a.bkt.clouddn.com/csharp-sdk-ref-v7.2.15/index.html)
16-
17-
* [CHM文件下载](http://oiy037d6a.bkt.clouddn.com/QiniuCSharpSDK-Ref-v7.2.15.chm)
18-
19-
以下链接提供了一些示例(包含**UWP应用**示例),参考这些示例可以帮助您更快熟悉如何使用这套SDK。
20-
21-
* [qiniu/csharp-sdk/examples](https://github.com/qiniu/csharp-sdk/tree/master/examples)
22-
23-
* [C# SDK使用指南 | 代码示例](http://oiy037d6a.bkt.clouddn.com/csharp-sdk-man-v7.2.15/index.html)
24-
25-
## 如何安装
26-
27-
当前最新版本及最新改动同步在master分支。
28-
29-
以下是安装SDK的几种不同的方式,您可以根据需要来选择。
30-
31-
**1. 直接添加DLL引用**
32-
33-
您可以在[这里](https://github.com/qiniu/csharp-sdk/releases)找到所有的Release,选择您需要的版本下载,解压后将*.dll文件添加至项目引用。需要注意的是,此SDK依赖[Json.NET](http://www.newtonsoft.com/json),可以添加对应版本Newtonsoft.Json.dll引用或者使用NuGet来安装它:
34-
35-
```
36-
Install-Package Newtonsoft.Json
37-
```
38-
39-
**2. 包管理器(NuGet)安装**
40-
41-
或者从NuGet来安装,以Visual Studio 2013/2015为例,打开NuGet程序包管理器搜索`Qiniu.Shared`或者在控制台中键入以下命令:
42-
43-
```
44-
Install-Package Qiniu.Shared
45-
```
46-
47-
**3. 从源码编译**
48-
49-
当然,您也可以直接从源码编译
50-
51-
```
52-
git clone https://github.com/qiniu/csharp-sdk
53-
```
54-
55-
## 如何编译
56-
57-
推荐使用VS2013及以上版,根据目标平台选择对应的解决方案文件并打开:
58-
59-
| 目标 | 解决方案文件 |
60-
|--------|--------|
61-
| .NET Framework 2.0 | Qiniu.Net20.sln |
62-
| .NET Framework 3.5 | Qiniu.Net35.sln |
63-
| .NET Framework 4.0 | Qiniu.Net40.sln |
64-
| .NET Framework 4.5 | Qiniu.Net45.sln |
65-
| .NET Framework 4.6 | Qiniu.Net46.sln |
66-
| .NET Core | Qiniu.Core.sln |
67-
| Win10 UWP| Qiniu.UWP.sln |
68-
| 以上全部 | Qiniu.ALL_VER.sln |
69-
| 单元测试(NUnit) | Qiniu.UnitTest.sln |
70-
| 单元测试(for UWP) | Qiniu.MSTest.sln |
71-
72-
**注意**
73-
74-
如需编译`Qiniu.Core.sln`(或`Qiniu.UWP.sln`),请先将`Qiniu.NetCore`(或`Qiniu.UWP`)文件夹下的
75-
`project.json``project.lock.json`拷贝至`Qiniu`文件夹下,或者只拷贝`project.json`文件然后执行`dotnet restore`命令(推荐)。
76-
77-
编译其他版本时,如果`Qiniu`文件夹下有`project.json``project.lock.json`,请先删除。
78-
79-
## API参考手册
80-
81-
* [对象存储API参考手册](http://developer.qiniu.com/article/index.html#kodo-api-handbook)
82-
83-
* [数据处理API参考手册](http://developer.qiniu.com/article/index.html#dora-api-handbook)
84-
85-
* [融合CDN加速API参考手册](http://developer.qiniu.com/article/index.html#fusion-api-handbook)
86-
87-
## 相关资源
88-
89-
如果您有任何关于我们文档或产品的建议和想法,欢迎到我们的技术论坛参与讨论。
90-
91-
* [技术论坛](http://segmentfault.com/qiniu) - 在这里您可以和其他开发者愉快的讨论如何更好的使用七牛云服务
92-
93-
* [提交工单](http://support.qiniu.com/hc/request/guest/) - 如果您的问题不适合在论坛讨论或得不到回答,您也可以提交一个工单,技术支持人员会尽快回复您
94-
95-
* [博客](http://blog.qiniu.com/) - 这里会持续发布市场活动和技术分享文章
96-
97-
* [微博](http://weibo.com/qiniutek)
98-
99-
* [常见问题](http://developer.qiniu.com/article/faqs/)
1008

1019
## 贡献代码
10210

@@ -113,130 +21,4 @@ git clone https://github.com/qiniu/csharp-sdk
11321

11422
## 许可证
11523

116-
Copyright (c) 2017 [qiniu.com](www.qiniu.com)
117-
118-
基于 MIT 协议发布:
119-
120-
www.opensource.org/licenses/MIT
121-
122-
## 附录
123-
124-
### 速览.NET Core
125-
126-
下面是一个入门向导,如果您对如何创建及使用.NET Core程序还不太熟悉,可以参考;如果您已经比较熟悉,可以直接略过(或者也可以帮助我们改进^_^)。
127-
128-
开始之前,您需要准备`dotnet`工具,参见https://github.com/dotnet/cli/
129-
130-
以下步骤基本上都是在命令行终端下执行(如Windows的命令行控制台,Ubuntu/Mac的终端)。
131-
132-
#### 1. 创建
133-
134-
首先切换到您的项目工作目录,然后键入以下命令来创建一个新的项目:
135-
136-
```
137-
dotnet new
138-
dotnet restore
139-
```
140-
141-
**注意**
142-
143-
在执行`dotnet restore`之前,您可以在文本编辑器中打开并修改`project.json`文件(这个文件在执行`dotnet new`后就会自动生成)内容,下面是一个示例:
144-
145-
```json
146-
{
147-
"version": "1.0.0-*",
148-
"buildOptions": {
149-
"emitEntryPoint": true
150-
},
151-
152-
"dependencies": {
153-
"Microsoft.NETCore.App": {
154-
"version": "1.0.1"
155-
},
156-
"Qiniu": "7.1.0.0",
157-
"Newtonsoft.Json": "9.0.1"
158-
},
159-
160-
"frameworks": {
161-
"netcoreapp1.0": {
162-
"imports": "dnxcore50"
163-
}
164-
},
165-
166-
"runtimes": {
167-
"win7-x64": {},
168-
"win7-x86": {},
169-
"osx.10.10-x64": {},
170-
"osx.10.11-x64": {},
171-
"ubuntu.14.04-x64": {},
172-
"ubuntu.16.04-x64": {}
173-
}
174-
}
175-
```
176-
177-
创建好项目之后就可以编写您的csharp代码了。
178-
179-
#### 2. 发布
180-
181-
根据您的目标平台(操作系统),选择其中一个来执行:
182-
183-
```
184-
dotnet publish -r win7-x64
185-
dotnet publish -r ubuntu.16.04-x64
186-
dotnet publish -r osx.10.11-x64
187-
```
188-
189-
发布之后,直接拷贝发布目录下的所有文件到目标计算机就可以直接使用。
190-
191-
如果目标平台上已经安装了.NET Core运行时,那么您需要做的就是编译:
192-
193-
```
194-
dotnet build
195-
```
196-
197-
#### 3. 执行
198-
199-
**如果您使用的是OSX 10.11(EI Capitan)**, 请先安装openssl:
200-
201-
```
202-
brew update
203-
brew install openssl
204-
brew link --force openssl
205-
ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
206-
ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/
207-
```
208-
209-
假设您编译好的程序(*built app*)是`Example.dll`,您可以键入以下命令来执行:
210-
211-
```
212-
dotnet Example.dll
213-
```
214-
215-
当然,执行这个命令之前,`dotnet`工具是必须安装的。
216-
217-
如果您发布到Windows并且生成了exe文件,直接双击就可以运行。
218-
219-
###速览Win10 UWP
220-
221-
Win10 UWP是指“Windows 10 通用应用”,它和之前的.NET应用开发有一些区别,比如文件存储使用的是StorageFolder和StorageFile等。具体请参阅Windows官方文档。
222-
223-
同样的,UWP解决方案中也包含一个project.json文件,以下是一个简单的示例:
224-
225-
```json
226-
{
227-
"dependencies": {
228-
"Microsoft.NETCore.UniversalWindowsPlatform": "5.1.0"
229-
},
230-
"frameworks": {
231-
"uap10.0": {}
232-
},
233-
"runtimes": {
234-
"win10-arm": {},
235-
"win10-arm-aot": {},
236-
"win10-x86": {},
237-
"win10-x86-aot": {},
238-
"win10-x64": {},
239-
"win10-x64-aot": {}
240-
}
241-
}
242-
```
24+
Copyright (c) 2017 [qiniu.com](www.qiniu.com)

0 commit comments

Comments
 (0)