अर्थात् संस्करण में "सार्वजनिक एपीआई" का अर्थ क्या है?

Question

मैं http://semver.org/ से "अर्थपूर्ण संस्करण" नामक नियम के साथ संस्करण संख्याओं को असाइन और बढ़ाने के बारे में सीख रहा हूं।

अपने सभी नियमों के अलावा, पहले एक ने कहा:

सिमेंटिक संस्करण का उपयोग कर सॉफ्टवेयर चाहिए एक सार्वजनिक एपीआई घोषणा करते हैं। इस एपीआई को कोड में ही घोषित किया जा सकता है या दस्तावेज़ीकरण में सख्ती से मौजूद है। हालांकि यह किया जाता है, यह सटीक और व्यापक होना चाहिए "

मैं के बारे में उलझन में हूँ" सार्वजनिक एपीआई "। यह?

करने का क्या अर्थ है

Answer 1

सार्वजनिक एपीआई को संदर्भित करता है" "उपयोग की बात यह है कि बाहरी दुनिया (उपयोगकर्ता, अन्य कार्यक्रम और/या प्रोग्रामर इत्यादि) आपके सॉफ़्टवेयर के लिए हैं।

उदाहरण के लिए, यदि आप लाइब्रेरी विकसित कर रहे हैं, तो सार्वजनिक एपीआई आपके पुस्तकालय में किए जा सकने वाले सभी विधियों के आविष्कारों का सेट है

यह समझ में आता है कि, जब तक कोई बड़ा संस्करण नहीं बदलता, आपका एपीआई डब्ल्यू बीमार पीछे-संगत हो, यानी सभी संस्करण जो संस्करण पर मान्य थे, बाद के संस्करण पर मान्य होंगे। आप उन नियमों की बात 9 में पढ़ सकते हैं:

मेजर संस्करण एक्स (X.y.z | एक्स> 0) वृद्धि किया जाना चाहिए किसी भी पीछे की ओर असंगत परिवर्तन सार्वजनिक एपीआई के लिए पेश कर रहे हैं।

Answer 2

इसे प्रभावी रूप से इसके संस्करण पैटर्न को लागू करने के लिए एक सार्वजनिक एपीआई की आवश्यकता है।

उदाहरण के लिए:

बग एपीआई को प्रभावित नहीं फिक्स पैच संस्करण

पिछड़ों संगत एपीआई जोड़ना/परिवर्तन को बढ़ा देते नाबालिग संस्करण को बढ़ा देते हैं, और ...

पिछड़ों असंगत एपीआई परिवर्तन बड़े संस्करण में वृद्धि।

यह या दस्तावेज शामिल हो सकते हैं कोड से ही लागू किया जाना: वे भी SemVer दस्तावेज़ में राज्य के रूप में

क्या अपने एपीआई का प्रतिनिधित्व करता है, व्यक्तिपरक है।